コレクションメソッドはPLサブルーチンに属し、コレクション情報を返す関数またはコレクションを操作するプロシージャである可能性があります。
適用対象
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
コレクションメソッドにより、コレクションの使用と保守が容易になります。
説明
空のコレクションに対して、EXISTSは定義済み例外COLLECTION_IS_NULLを引き起こさない唯一のコレクションメソッドです。
OceanBaseデータベースがサポートするコレクションメソッドは以下の表のとおりです。
| メソッド | タイプ | 説明 |
|---|---|---|
| DELETE | ステートメント | コレクションの要素を削除します。 |
| TRIM | ステートメント | 変数配列またはネストテーブルの末尾から要素を削除します。 |
| EXTEND | ステートメント | 要素を変数配列またはネストテーブルの末尾に追加します。 |
| EXISTS | 関数 | 指定された要素が変数配列またはネストテーブルに存在する場合に限り、TRUE を返します。 |
| FIRST | 関数 | コレクション内の最初のインデックスを返します。 |
| LAST | 関数 | コレクション内の最後のインデックスを返します。 |
| COUNT | 関数 | コレクション内の要素数を返します。 |
| LIMIT | 関数 | コレクションが収容できる最大要素数を返します。 |
| PRIOR | 関数 | 指定されたインデックスより前のインデックスを返します。 |
| NEXT | 関数 | 指定されたインデックスより後のインデックスを返します。 |
コレクションメソッドを呼び出すための基本構文は次のとおりです:
collection_name.method
コレクションメソッドは、そのタイプ(関数またはプロシージャ)のPLサブルーチン内から呼び出すことができますが、SQLステートメント内から呼び出すことはできません。
サブルーチン内では、コレクションパラメータはバインドされたパラメータのプロパティを使用します。このようなパラメータにコレクションメソッドを適用できます。可変配列パラメータの場合、パラメータモードに関係なく、LIMITの値は常にパラメータ型の定義から得られます。