オブジェクトおよびファイル用のDBMS_CLOUD

この項では、オブジェクトおよびファイルの操作に使用するDBMS_CLOUDサブプログラムについて説明します。

前提条件

開発者は、Oracle Public CloudマルチクラウドまたはExadata Cloud@CustomerにデプロイされたAutonomous DatabaseでDBMS_CLOUDプロシージャを使用できます。

デプロイメントの選択肢に応じて、Amazon S3Azure Blob StorageおよびGoogle Cloud Storageサービス・プロバイダでDBMS_CLOUDプロシージャを使用するには、次の前提条件を満たす必要があります。

アウトバウンド接続は、次に説明するようにフリート管理者によってNATゲートウェイを使用して構成されている必要があります:
  • Oracle Cloud InfrastructureドキュメンテーションNAT Gatewayの作成の説明に従って、Autonomous Databaseリソースが存在するVirtual Cloud Network (VCN)でNATゲートウェイを作成します。
  • NATゲートウェイを作成したら、Autonomous Databaseリソースが存在する各サブネット(VCN内)にルート・ルールおよびエグレス・セキュリティ・ルールを追加して、これらのリソースがゲートウェイを使用してAzure ADインスタンスから公開キーを取得できるようにします:
    1. サブネットの「サブネットの詳細」ページに移動します。
    2. Subnet Information」タブで、サブネットの「Route Table」の名前をクリックして、その「Route Table Details」ページを表示します。
    3. 既存のルート・ルールの表で、次の特性を持つルールがすでに存在します:
      • 宛先: 0.0.0.0/0
      • ターゲット・タイプ: NAT Gateway
      • ターゲット: VCN内に作成したNATゲートウェイの名前

      このようなルールが存在しない場合は、「ルート・ルールの追加」をクリックし、これらの特性を持つルート・ルールを追加します。

    4. サブネットの「サブネットの詳細」ページに戻ります。
    5. サブネットの「セキュリティ・リスト」表で、サブネットのセキュリティ・リストの名前をクリックして、その「セキュリティ・リストの詳細」ページを表示します。
    6. サイド・メニューの「リソース」で、「エグレス・ルール」をクリックします。
    7. 既存のエグレス・ルールの表で、次の特性を持つルールがすでに存在します:
      • 宛先タイプ: CIDR
      • 宛先: 0.0.0.0/0
      • IPプロトコル: TCP
      • ソース・ポート範囲: 443
      • 宛先ポート範囲: すべて

      そのようなルールが存在しない場合は、「エグレス・ルールの追加」をクリックし、これらの特性を持つエグレス・ルールを追加します。

環境のHTTPプロキシ設定では、データベースがクラウド・サービス・プロバイダにアクセスできるようにする必要があります。

これらの設定は、Exadata Cloud@Customerインフラストラクチャの作成時にフリート管理者が定義します(コンソールを使用したExadata Database Service on Cloud@Customerのプロビジョニングを参照)。

ノート:

HTTPプロキシを含むネットワーク構成は、Exadataインフラストラクチャが「アクティブ化が必要」状態になるまで編集できます。いったんアクティブ化すると、それらの設定は編集できません。

すでにプロビジョニングされているExadataインフラストラクチャのHTTPプロキシを設定するには、My Oracle Supportでサービス・リクエスト(SR)が必要です。詳細は、My Oracle Supportでのサービス・リクエストの作成を参照してください。

オブジェクトおよびファイル用のDBMS_CLOUDサブプログラム

DBMS_CLOUDパッケージ内のオブジェクト管理およびファイル管理用のサブプログラム。

サブプログラム 説明

COPY_COLLECTIONプロシージャ

このプロシージャは、クラウド・オブジェクト・ストレージまたはディレクトリ内のファイルから、既存のSODAコレクションにデータをロードします。

COPY_DATAプロシージャ

このプロシージャは、クラウド・オブジェクト・ストレージまたはディレクトリ内のファイルからAutonomous Databaseの既存の表にデータをロードします。

COPY_DATA Avro、ORCまたはParquetファイル用のプロシージャ

このプロシージャは、formatパラメータのtypeを値orcparquetまたはavroに設定すると、クラウドのORC、ParquetまたはAvroファイルから、またはディレクトリ内のORC、ParquetまたはAvroファイルから、既存のAutonomous Database表にデータをロードします。

テキスト・ファイルと同様に、データはソースのORC、ParquetまたはAvroファイルから既存の内部表にコピーされます。

COPY_OBJECTプロシージャ

このプロシージャは、あるクラウド・オブジェクト・ストレージ・バケットから別のクラウド・オブジェクト・ストレージ・バケットにファイルをコピーします。

CREATE_EXTERNAL_TABLEプロシージャ

このプロシージャでは、クラウド内のファイルまたはディレクトリ内のファイルに外部表を作成します。これにより、Autonomous Databaseから外部データに対する問合せを実行できます。

CREATE_EXTERNAL_TABLE Avro、ORCまたはParquetファイル用のプロシージャ

このプロシージャは、formatパラメータのtypeを値parquetorcまたはavroに設定することで、クラウドまたはディレクトリ内のParquet、ORCまたはAvroフォーマット・ファイルを使用して外部表を作成します。

これにより、Autonomous Databaseから外部データに対する問合せを実行できます。

CREATE_EXTERNAL_TEXT_INDEXプロシージャ

このプロシージャは、オブジェクト・ストア・ファイルにテキスト索引を作成します。

CREATE_HYBRID_PART_TABLEプロシージャ

このプロシージャでは、ハイブリッド・パーティション表を作成します。これにより、Autonomous Databaseからハイブリッド・パーティション・データに対して問合せを実行できます。

DELETE_ALL_OPERATIONSプロシージャ

このプロシージャは、スキーマ内のuser_load_operations表に記録されたすべてのデータ・ロード操作をクリアするか、typeパラメータで示されている、指定されたタイプのすべてのデータ・ロード操作をクリアします。

DELETE_FILEプロシージャ

このプロシージャは、Autonomous Database上の指定されたディレクトリから指定されたファイルを削除します

DELETE_OBJECTプロシージャ

このプロシージャは、オブジェクト・ストアの指定されたオブジェクトを削除します。

DELETE_OPERATIONプロシージャ

このプロシージャは、入力としてoperation_idを受け入れ、指定したoperation_idに関連付けられているログを削除します。

DROP_EXTERNAL_TEXT_INDEXプロシージャ

このプロシージャは、オブジェクト・ストア・ファイルのテキスト索引を削除します。

EXPORT_DATAプロシージャ

このプロシージャは、問合せの結果として、Autonomous Databaseからクラウドのファイルにデータをエクスポートします。オーバーロード・フォームでは、operation_idパラメータを使用できます。指定されたformatパラメータのtypeオプションに応じて、プロシージャは、CSV、JSON、ParquetまたはXMLのオプションを含むテキストとして行をクラウド・オブジェクト・ストアにエクスポートします

GET_OBJECTプロシージャおよびファンクション

このプロシージャはオーバーロードされています。このプロシージャ・フォームは、Cloud Object Storageからオブジェクトを読み取り、Autonomous Databaseにコピーします。このファンクション・フォームは、Cloud Object Storageからオブジェクトを読み取り、BLOBAutonomous Databaseに返します。

LIST_FILESファンクション

このファンクションは、指定されたディレクトリ内のファイルを一覧表示します。結果には、ファイル名と、ファイルに関する追加のメタデータ(ファイル・サイズ(バイト)、作成タイムスタンプ、最終変更タイムスタンプなど)が含まれます。

LIST_OBJECTSファンクション

このファンクションは、オブジェクト・ストアの指定された場所にあるオブジェクトを一覧表示します。結果には、オブジェクト名と、オブジェクトに関する追加のメタデータ(サイズ、チェックサム、作成タイムスタンプ、最終変更タイムスタンプなど)が含まれます。

MOVE_OBJECTプロシージャ

このプロシージャは、あるクラウド・オブジェクト・ストレージ・バケットから別のバケットにオブジェクトを移動します。

PUT_OBJECTプロシージャ

このプロシージャはオーバーロードされています。ある形式では、このプロシージャはファイルをAutonomous DatabaseからCloud Object Storageにコピーします。別の形式では、Autonomous Databaseからクラウド・オブジェクト・ストレージにBLOBをコピーします。

SYNC_EXTERNAL_PART_TABLEプロシージャ

このプロシージャは、クラウドのファイルの外部パーティション表の更新を簡略化します。このプロシージャは、新しいパーティションが追加されたとき、またはパーティションが外部パーティション表のオブジェクト・ストア・ソースから削除されたときに実行します。

VALIDATE_EXTERNAL_TABLEプロシージャ

このプロシージャは、外部表のソース・ファイルを検証し、ログ情報を生成して、外部表に指定されたフォーマット・オプションと一致しない行をAutonomous Databasebadfile表に格納します。

VALIDATE_EXTERNAL_PART_TABLEプロシージャ

このプロシージャは、外部パーティション表のソース・ファイルを検証し、ログ情報を生成し、外部表に指定されたフォーマット・オプションと一致しない行をAutonomous Databasebadfile表に格納します。

VALIDATE_HYBRID_PART_TABLEプロシージャ

このプロシージャは、ハイブリッド・パーティション表のソース・ファイルを検証し、ログ情報を生成し、ハイブリッド表に指定されたフォーマット・オプションと一致しない行をAutonomous Databasebadfile表に格納します。

COPY_COLLECTIONプロシージャ

このプロシージャは、クラウド・オブジェクト・ストレージまたはディレクトリからSODAコレクションにデータをロードします。指定したSODAコレクションが存在しない場合は、プロシージャによって作成されます。オーバーロード・フォームでは、operation_idパラメータを使用できます。

構文

DBMS_CLOUD.COPY_COLLECTION (
    collection_name   IN VARCHAR2,
    credential_name   IN VARCHAR2 DEFAULT NULL,
    file_uri_list     IN CLOB,
    format            IN CLOB     DEFAULT NULL
);

DBMS_CLOUD.COPY_COLLECTION (
    collection_name   IN VARCHAR2,
    credential_name   IN VARCHAR2 DEFAULT NULL,
    file_uri_list     IN CLOB,
    format            IN CLOB     DEFAULT NULL,
    operation_id      OUT NOCOPY NUMBER
);

Parameters

パラメータ 説明

collection_name

データのロード先のSODAコレクションの名前。この名前のコレクションがすでに存在する場合は、指定したデータがロードされ、そうでない場合は新しいコレクションが作成されます。

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

file_uri_listでディレクトリを指定する場合、このパラメータは使用されません。

file_uri_list

このパラメータでは、ソース・ファイルURIのカンマ区切りリスト、または1つ以上のディレクトリとソース・ファイルを指定します。

クラウド・ソース・ファイルのURI

クラウド・ソース・ファイルURIのファイル名には、ワイルドカードおよび正規表現を使用できます。

正規表現を使用できるのは、regexuri formatパラメータがTRUEに設定されている場合のみです。

regexuriパラメータがFALSEに設定されている場合、文字"*"および"?"はワイルドカード文字とみなされます。regexuriパラメータがTRUEに設定されている場合、文字"*"および"?"は指定された正規表現パターンの一部です。

正規表現パターンは、URI内のファイル名またはサブフォルダ・パスでのみサポートされ、パターン一致はREGEXP_LIKE関数によって実行されるものと同じです。

たとえば次のようにします。

file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.csv'

URIのフォーマットは、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

REGEXP_LIKE条件の詳細は、『Oracle Database 19c SQL言語リファレンス』REGEXP_LIKE条件または『Oracle Database 23ai SQL言語リファレンス』を参照してください。

ディレクトリ

1つのディレクトリと1つ以上のファイル名を指定することも、ディレクトリとファイル名のカンマ区切りリストを使用することもできます。ディレクトリを指定する形式は、'MY_DIR:filename.ext'です。デフォルトでは、ディレクトリ名MY_DIRはデータベース・オブジェクトであり、大/小文字は区別されません。ファイル名は、大/小文字が区別されます。

ワイルドカードを使用して、ディレクトリ内のファイル名を指定できます。文字"*"は複数の文字を表すワイルドカードとして、文字"?"は1つの文字を表すワイルドカードとして使用できます。例:'MY_DIR:*"または'MY_DIR:test?'

複数のディレクトリを指定するには、ディレクトリのカンマ区切りリストを使用します。例:'MY_DIR1:*, MY_DIR2:test?'

大/小文字を区別するディレクトリ名を指定するには、二重引用符を使用します。例:'"my_dir1":*, "my_dir2":Test?'

引用符文字を含めるには、2つの引用符を使用します。例:'MY_DIR:''filename.ext'。これは、filenameが引用符(')で始まることを示します。

format

ソース・ファイルのフォーマットを説明するオプション。これらのオプションはJSON文字列として指定されます。

サポートされている形式は、characterset, compression, ignoreblanklines, jsonpath, maxdocsize, recorddelimiter, rejectlimit, unpackarraykeyassignmentおよびkeypathです。

前述したJSONデータのフォーマットとは別に、Autonomous Databaseでは他のフォーマットもサポートされています。Autonomous Databaseでサポートされているformat引数のリストは、「Formatパラメータ」を参照してください。

operation_id

このパラメータを使用して、USER_LOAD_OPERATIONSビューで、ロード操作の進行状況および最終ステータスを対応するIDとして追跡します。

BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
            credential_name => 'OBJ_STORE_CRED',
            username        => 'user_name@oracle.com',
            password        => 'password'
            );

    DBMS_CLOUD.COPY_COLLECTION(
            collection_name => 'myCollection',
            credential_name => 'OBJ_STORE_CRED',
            file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/adbexample/b/json/o/myCollection.json'  
            );
END;
/

COPY_DATAプロシージャ

このプロシージャは、クラウドのファイルまたはディレクトリ内のファイルからAutonomous Databaseの既存の表にデータをロードします。オーバーロード・フォームでは、operation_idパラメータを使用できます。

構文

DBMS_CLOUD.COPY_DATA (
    table_name        IN VARCHAR2,
    credential_name   IN VARCHAR2 DEFAULT NULL,
    file_uri_list     IN CLOB,
    schema_name       IN VARCHAR2,
    field_list        IN CLOB,
    format            IN CLOB);

DBMS_CLOUD.COPY_DATA (
    table_name        IN VARCHAR2,
    credential_name   IN VARCHAR2 DEFAULT NULL,
    file_uri_list     IN CLOB DEFAULT NULL,
    schema_name       IN VARCHAR2 DEFAULT NULL,
    field_list        IN CLOB DEFAULT NULL,
    format            IN CLOB DEFAULT NULL
    operation_id      OUT NOCOPY NUMBER);

Parameters

パラメータ 説明

table_name

データベースのターゲット表の名前。ターゲット表はCOPY_DATAを実行する前に作成しておく必要があります。

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

file_uri_listでディレクトリを指定する場合、このパラメータは使用されません。

file_uri_list

クラウド・ソース・ファイルURIのファイル名には、ワイルドカードおよび正規表現を使用できます。

クラウド・ソース・ファイルのURI

このパラメータでは、ソース・ファイルURIのカンマ区切りリスト、または1つ以上のディレクトリとソース・ファイルを指定します。

正規表現を使用できるのは、regexuri formatパラメータがTRUEに設定されている場合のみです。

regexuriパラメータがFALSEに設定されている場合、文字"*"および"?"はワイルドカード文字とみなされます。regexuriパラメータがTRUEに設定されている場合、文字"*"および"?"は指定された正規表現パターンの一部です。

正規表現パターンは、URI内のファイル名またはサブフォルダ・パスでのみサポートされ、パターン一致はREGEXP_LIKE関数によって実行されるものと同じです。

たとえば次のようにします。

file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.csv'

URIのフォーマットは、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

REGEXP_LIKE条件の詳細は、『Oracle Database 19c SQL言語リファレンス』REGEXP_LIKE条件または『Oracle Database 23ai SQL言語リファレンス』を参照してください。

ディレクトリ

1つのディレクトリと1つ以上のファイル名を指定することも、ディレクトリとファイル名のカンマ区切りリストを使用することもできます。ディレクトリを指定する形式は、'MY_DIR:filename.ext'です。デフォルトでは、ディレクトリ名MY_DIRはデータベース・オブジェクトであり、大/小文字は区別されません。ファイル名は、大/小文字が区別されます。

ワイルドカードを使用して、ディレクトリ内のファイル名を指定できます。文字"*"は複数の文字を表すワイルドカードとして、文字"?"は1つの文字を表すワイルドカードとして使用できます。例:'MY_DIR:*"または'MY_DIR:test?'

複数のディレクトリを指定するには、ディレクトリのカンマ区切りリストを使用します。例:'MY_DIR1:*, MY_DIR2:test?'

大/小文字を区別するディレクトリ名を指定するには、二重引用符を使用します。例:'"my_dir1":*, "my_dir2":Test?'

引用符文字を含めるには、2つの引用符を使用します。例:'MY_DIR:''filename.ext'。これは、filenameが引用符(')で始まることを示します。

schema_name

ターゲット表が存在するスキーマの名前。デフォルト値はNULLで、ターゲット表がプロシージャを実行しているユーザーと同じスキーマ内に存在することを意味します。

field_list

ソース・ファイル内のフィールドとそのデータ型を識別します。デフォルト値はNULLで、フィールドおよびそのデータ型がcolumn_listパラメータによって決定されることを意味します。この引数の構文は、通常のOracle外部表のfield_list句と同じです。詳細は、Oracle Database 19cユーティリティまたはOracle Database 23aiユーティリティfield_listを参照してください。

formatパラメータのtypeオプション値がjsonの場合、このパラメータは無視されます。

field_listの使用例については、CREATE_EXTERNAL_TABLEプロシージャを参照してください。

format

ソース・ファイル、ログ・ファイルおよび不良ファイルの形式を示すオプション。オプションのリストと値の指定方法は、フォーマット・パラメータを参照してください。

Avro、 ORC、 or Parquetファイル形式オプションについては、DBMS_CLOUD Avro、 ORC、 or Parquet用のパッケージ形式オプションを参照してください。

operation_id

このパラメータを使用して、USER_LOAD_OPERATIONSビューで、ロード操作の進行状況および最終ステータスを対応するIDとして追跡します。

使用上のノート

デフォルトのレコード・区切り文字はdetected newlineです。detected newlineを指定すると、DBMS_CLOUDは、レコード・区切り文字として使用する適切な改行文字の自動検出を試行します。DBMS_CLOUDは、最初にWindows改行文字\r\nを検索します。Windows改行文字が見つかった場合、それがプロシージャのすべてのファイルのレコード・デリミタとして使用されます。Windows改行文字が見つからない場合、DBMS_CLOUDでは、UNIX/Linux改行文字\nが検索され、見つかった場合は\nがプロシージャのすべてのファイルのレコード・区切り文字として使用されます。ソース・ファイルで異なるレコード・区切り記号の組合せが使用されている場合は、KUP-04020: found record longer than buffer size supportedなどのエラーが発生する可能性があります。この場合、ソース・ファイルを変更して同じレコード・区切り文字を使用するか、同じレコード・区切り文字を使用するソース・ファイルのみを指定する必要があります。

recorddelmiterフォーマット・オプションの詳細は、フォーマット・パラメータを参照してください。

BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL(
            credential_name => 'DEF_CRED_NAME',
            username        => 'user_name@oracle.com',
            password        => 'password'
            );
END;
/
BEGIN
 DBMS_CLOUD.COPY_DATA(
    table_name =>'CHANNELS',
    credential_name =>'DEF_CRED_NAME',
    file_uri_list =>'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/channels.txt',
    format => json_object('delimiter' value ',')
 );
END;
/
BEGIN
    DBMS_CLOUD.COPY_DATA(
            table_name      => 'ORDERS',
            schema_name     => 'TEST_SCHEMA',
            credential_name => 'DEF_CRED_NAME',
	     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/adbexample/b/json/o/orde[r]s.tbl.1'
            format          =>  json_object('ignoreblanklines' value TRUE,
                                            'rejectlimit' value '0',
                                            'dateformat' value 'yyyy-mm-dd',
                                            'regexuri' value TRUE)
            );
END;
/

Avro、ORCまたはParquetファイル用のCOPY_DATAプロシージャ

このプロシージャは、formatパラメータのtypeを値avroorcまたはparquetに設定することで、クラウドのAvro、ORCまたはParquetファイルから、またはディレクトリ内のファイルから、既存のAutonomous Database表にデータをロードします。

テキスト・ファイルと同様に、データはソースのAvro、ORCまたはParquetファイルから既存の内部表にコピーされます。

構文

DBMS_CLOUD.COPY_DATA (
    table_name        IN VARCHAR2,
    credential_name   IN VARCHAR2 DEFAULT NULL,
    file_uri_list     IN CLOB,
    schema_name       IN VARCHAR2 DEFAULT,
    field_list        IN CLOB DEFAULT,
    format            IN CLOB DEFAULT);

Parameters

パラメータ 説明

table_name

データベースのターゲット表の名前。ターゲット表はCOPY_DATAを実行する前に作成しておく必要があります。

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

file_uri_listでディレクトリを指定する場合、このパラメータは使用されません。

file_uri_list

このパラメータでは、ソース・ファイルURIのカンマ区切りリスト、または1つ以上のディレクトリとソース・ファイルを指定します。

クラウド・ソース・ファイルのURI

クラウド・ソース・ファイルURIのファイル名には、ワイルドカードおよび正規表現を使用できます。

正規表現を使用できるのは、regexuri formatパラメータがTRUEに設定されている場合のみです。

regexuriパラメータがFALSEに設定されている場合、文字"*"および"?"はワイルドカード文字とみなされます。regexuriパラメータがTRUEに設定されている場合、文字"*"および"?"は指定された正規表現パターンの一部です。

正規表現パターンは、URI内のファイル名またはサブフォルダ・パスでのみサポートされ、パターン一致はREGEXP_LIKE関数によって実行されるものと同じです。

たとえば次のようにします。

file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.csv'

URIのフォーマットは、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

REGEXP_LIKE条件の詳細は、『Oracle Database 19c SQL言語リファレンス』REGEXP_LIKE条件または『Oracle Database 23ai SQL言語リファレンス』を参照してください。

ディレクトリ

1つのディレクトリと1つ以上のファイル名を指定することも、ディレクトリとファイル名のカンマ区切りリストを使用することもできます。ディレクトリを指定する形式は、'MY_DIR:filename.ext'です。デフォルトでは、ディレクトリ名MY_DIRはデータベース・オブジェクトであり、大/小文字は区別されません。ファイル名は、大/小文字が区別されます。

ワイルドカードを使用して、ディレクトリ内のファイル名を指定できます。文字"*"は複数の文字を表すワイルドカードとして、文字"?"は1つの文字を表すワイルドカードとして使用できます。例:'MY_DIR:*"または'MY_DIR:test?'

複数のディレクトリを指定するには、ディレクトリのカンマ区切りリストを使用します。例:'MY_DIR1:*, MY_DIR2:test?'

大/小文字を区別するディレクトリ名を指定するには、二重引用符を使用します。例:'"my_dir1":*, "my_dir2":Test?'

引用符文字を含めるには、2つの引用符を使用します。例:'MY_DIR:''filename.ext'。これは、filenameが引用符(')で始まることを示します。

schema_name

ターゲット表が存在するスキーマの名前。デフォルト値はNULLで、ターゲット表がプロシージャを実行しているユーザーと同じスキーマ内に存在することを意味します。

field_list

Avro、ORCまたはParquetファイルでは無視されます。

ソースのフィールドは、名前で外部表の列を照合します。ソースのデータ型は外部表の列データ型に変換されます。

ORCファイルについては、DBMS_CLOUD ORCからOracleデータ型へのマッピングのパッケージ化を参照してください。

Parquetファイルの場合、マッピングの詳細は、DBMS_CLOUDパッケージのParquetからOracleデータ型へのマッピングを参照してください。

Avroファイルの場合、DBMS_CLOUDパッケージのAvroからOracleデータ型へのマッピングを参照してください。

format

ソース・ファイルのフォーマットを説明するオプション。Avro、 ORC、 or Parquetファイルについては、2つのオプションのみがサポートされています。DBMS_CLOUD Avro、 ORC、 or Parquet用のパッケージ形式オプションを参照してください。

使用上のノート

  • 他のデータ・ファイルと同様に、Avro、ORCおよびParquetデータをロードすると、dba_load_operationsおよびuser_load_operationsの各表で表示可能なログが生成されます。ロード操作ごとに、ログを含む表を示すdba[user]_load_operationsにレコードが追加されます。

    ログ表には、ロードに関するサマリー情報が含まれます。

  • Avro、ORCまたはParquetでは、formatパラメータのtypeが値avroorcまたはparquetに設定されていると、BADFILE_TABLE表は常に空です。

    • Parquetファイルの場合は、PRIMARY KEY制約エラーによってORAエラーがスローされます。

    • 列のデータに変換エラーが発生すると(たとえば、ターゲット列のサイズが変換後の値を保持するには不十分な場合)、その列の値はNULLに設定されます。これにより拒否レコードは生成されません。

COPY_OBJECTプロシージャ

このプロシージャは、あるクラウド・オブジェクト・ストレージ・バケットまたはフォルダから別のクラウド・オブジェクト・ストレージ・バケットにオブジェクトをコピーします。

ソース・バケットまたはターゲット・フォルダは、同じクラウド・オブジェクト・ストア・プロバイダまたは異なるクラウド・オブジェクト・ストア・プロバイダに配置できます。

ソースとターゲットが個別のオブジェクト・ストアにある場合、または同じクラウド・プロバイダを持つ異なるアカウントがある場合、ソースとターゲットの場所に個別の資格証明名を指定できます。

ターゲット資格証明名が指定されていない場合、ソース資格証明名はターゲットの場所でもデフォルトで使用されます。

構文

DBMS_CLOUD.COPY_OBJECT (
    source_credential_name  IN  VARCHAR2 DEFAULT NULL,
    source_object_uri       IN  VARCHAR2,
    target_object_uri       IN  VARCHAR2,
    target_credential_name  IN  VARCHAR2 DEFAULT NULL
);

Parameters

パラメータ 説明

source_credential_name

ソースのCloud Object Storageにアクセスするための資格証明の名前。

source_credential_name値を指定しない場合、credential_nameNULLに設定されます。

source_object_uri

ソース・オブジェクト・ストレージ・バケットまたはフォルダの場所を指すURIを指定します。

このパラメータは必須です。

URIのフォーマットは、クラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

target_object_uri

ターゲット・オブジェクト・ストアのURIを指定します。

このパラメータは必須です。

URIのフォーマットは、クラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

target_credential_name

ターゲットのCloud Object Storageの場所にアクセスするための資格証明の名前。

target_credential_name値を指定しない場合、target_object_urisource_credential_name値に設定されます。

BEGIN 
DBMS_CLOUD.COPY_OBJECT (
    source_credential_name => 'OCI_CRED',
    source_object_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/bgfile.csv',
    target_object_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/myfile.csv'
);
END;
/

CREATE_EXTERNAL_PART_TABLEプロシージャ

このプロシージャでは、クラウド内のファイル、またはディレクトリ内のファイルから外部パーティション表を作成します。これにより、Autonomous Databaseから外部データに対する問合せを実行できます。

構文

DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE (
    table_name           IN VARCHAR2,
    credential_name      IN VARCHAR2,
    partitioning_clause  IN CLOB,
    column_list          IN CLOB,
    field_list           IN CLOB DEFAULT,
    format               IN CLOB DEFAULT);


DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE (
    table_name           IN VARCHAR2,
    credential_name      IN VARCHAR2,
    file_uri_list        IN VARCHAR2,
    column_list          IN CLOB,
    field_list           IN CLOB DEFAULT,
    format               IN CLOB DEFAULT);

Parameters

パラメータ 説明

table_name

外部表の名前。

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

partitioning_clause

個々のパーティションの場所情報を含む完全なパーティション化句を指定します。

partitioning_clauseパラメータを使用する場合、file_uri_listパラメータは許可されません。

file_uri_list

このパラメータでは、ソース・ファイルURIのカンマ区切りリスト、または1つ以上のディレクトリとソース・ファイルを指定します。

クラウド・ソース・ファイルのURI

クラウド・ソース・ファイルURIのファイル名には、ワイルドカードおよび正規表現を使用できます。

正規表現を使用できるのは、regexuri formatパラメータがTRUEに設定されている場合のみです。

regexuriパラメータがFALSEに設定されている場合、文字"*"および"?"はワイルドカード文字とみなされます。regexuriパラメータがTRUEに設定されている場合、文字"*"および"?"は指定された正規表現パターンの一部です。

正規表現パターンは、URI内のファイル名またはサブフォルダ・パスでのみサポートされ、パターン一致はREGEXP_LIKE関数によって実行されるものと同じです。

このオプションは、オブジェクト・ストレージのファイルに作成された外部表でのみサポートされます。

たとえば次のようにします。

file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.csv'

パラメータfile_uri_listを使用する場合、partitioning_clauseパラメータは許可されません。

URIのフォーマットは、クラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

REGEXP_LIKE条件の詳細は、『Oracle Database 19c SQL言語リファレンス』REGEXP_LIKE条件または『Oracle Database 23ai SQL言語リファレンス』を参照してください。

column_list

外部表の列名およびデータ型のカンマ区切りリスト。このパラメータには、file_uri_listパラメータで指定されたデータ・ファイルのタイプに応じて、次の要件があります。

  • 非構造化ファイルでは、column_listパラメータは必須です。非構造化ファイル(CSVテキスト・ファイルなど)を使用する場合、column_listパラメータでは、データ・ファイル内のすべての列名、データ型、およびオブジェクト名から導出されたパーティション列を指定する必要があります。

  • 構造化ファイルでは、column_listパラメータはオプションです。たとえば、Avro、ORCまたはParquetデータ・ファイルでは、column_listは必要ありません。column_listを含めない場合、formatパラメータのpartition_columnsオプションには、列名(name)とデータ型(type)の両方の指定を含める必要があります。

field_list

ソース・ファイル内のフィールドとそのデータ型を識別します。デフォルト値はNULLで、フィールドおよびそのデータ型がcolumn_listパラメータによって決定されることを意味します。この引数の構文は、通常のOracle外部表のfield_list句と同じです。詳細は、Oracle Database 19cユーティリティまたはOracle Database 23aiユーティリティfield_listを参照してください。

format

フォーマット・オプションpartition_columnsでは、データ・ファイルのタイプに応じて、パーティション列がファイル・パスから導出されるときのパーティション列のDBMS_CLOUD.CREATE_EXTERNAL_PART_TABLEの列名とデータ型を指定します:

  • DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLEcolumn_listパラメータが含まれ、データ・ファイルが非構造化(CSVテキスト・ファイルなど)の場合、partition_columnsにはデータ型は含まれません。たとえば、このタイプのpartition_columnsの指定では、次のようなフォーマットを使用します:

    '"partition_columns":["state","zipcode"]'

    データ型は、DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLEcolumn_listパラメータで指定されるため、必須ではありません。

  • DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLEcolumn_listパラメータが含まれず、データ・ファイルが構造化(Avro、ORC、Parquetファイルなど)の場合、partition_columnsオプションには列名(name副句)とデータ型(type副句)の両方が含まれます。たとえば、partition_columnsの指定を次に示します:

    '"partition_columns":[
                   {"name":"country", "type":"varchar2(10)"},
                   {"name":"year", "type":"number"},
                   {"name":"month", "type":"varchar2(10)"}]'

データ・ファイルが構造化されておらず、type副句がpartition_columnsで指定されている場合、type副句は無視されます。

Hive形式に基づかないオブジェクト名の場合、partition_columnsで指定された列の順序は、file_uri_listパラメータで指定されたファイル・パスのオブジェクト名に表示される順序と一致する必要があります。

ソース・ファイルのフォーマットを説明するすべてのformatパラメータ・オプションを確認するには、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

使用上のノート

  • partitioning_clauseパラメータとfile_uri_listパラメータの両方を使用してこのプロシージャをコールすることはできません。

  • Avro、ParquetまたはORCデータ・ファイルを含む構造化データ・ファイルでは、column_listパラメータの指定はオプションです。column_listを指定しない場合、formatパラメータのpartition_columnsオプションには、nametypeの両方を含める必要があります。

  • CSVテキスト・ファイルなどの非構造化データ・ファイルでは、column_listパラメータは必須です。

  • プロシージャDBMS_CLOUD.CREATE_EXTERNAL_PART_TABLEは、サポートされているクラウド・オブジェクト・ストレージ・サービスで、次のような外部パーティション・ファイルをサポートします:
    • Oracle Cloud Infrastructure Object Storage

    • Azure Blob Storage

    詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

  • プロシージャDBMS_CLOUD.CREATE_EXTERNAL_PART_TABLEは、ローカル・ファイル・システムまたはネットワーク・ファイル・システム内のディレクトリ内の外部パーティション・ファイルをサポートします。

  • file_uri_listパラメータを指定してDBMS_CLOUD.CREATE_EXTERNAL_PART_TABLEをコールする場合、クラウド・オブジェクト・ストアのファイル名で指定される列の型は、次のいずれかの型である必要があります。

    VARCHAR2(n)
    NUMBER(n)
    NUMBER(p,s)
    NUMBER
    DATE
    TIMESTAMP(9)
  • デフォルトのレコード・区切り文字はdetected newlineです。detected newlineを指定すると、DBMS_CLOUDは、レコード・区切り文字として使用する適切な改行文字の自動検出を試行します。DBMS_CLOUDは、最初にWindows改行文字\r\nを検索します。Windows改行文字が見つかった場合、それがプロシージャのすべてのファイルのレコード・デリミタとして使用されます。Windows改行文字が検出されない場合、DBMS_CLOUDでは、UNIX/Linux改行文字\nが検索され、見つかった場合は\nがプロシージャのすべてのファイルのレコード・区切り文字として使用されます。ソース・ファイルで異なるレコード・区切り記号の組合せが使用されている場合は、KUP-04020: found record longer than buffer size supportedなどのエラーが発生する可能性があります。この場合、ソース・ファイルを変更して同じレコード・区切り文字を使用するか、同じレコード・区切り文字を使用するソース・ファイルのみを指定する必要があります。

    recorddelmiterフォーマット・オプションの詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

  • DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLEを使用して作成する外部パーティション表には、2つの非表示列file$pathおよびfile$nameが含まれます。これらの列は、レコードの取得元ファイルの識別に役立ちます。

    • file$path: オブジェクト名の先頭までのファイル・パス・テキストを指定します。

    • file$name: バケット名に続くすべてのテキストを含め、オブジェクト名を指定します。

partitioning_clauseパラメータを使用した例:

BEGIN  
   DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
      table_name =>'PET1',  
      credential_name =>'OBJ_STORE_CRED',
      format => json_object('delimiter' value ',', 'recorddelimiter' value 'newline', 'characterset' value 'us7ascii'),
      column_list => 'col1 number, col2 number, col3 number',
      partitioning_clause => 'partition by range (col1)
                                (partition p1 values less than (1000) location
                                    ( ''&base_URL//file_11.txt'')
                                 ,
                                 partition p2 values less than (2000) location
                                    ( ''&base_URL/file_21.txt'')
                                 ,
                                 partition p3 values less than (3000) location 
                                    ( ''&base_URL/file_31.txt'')
                                 )'
     );
   END;
/  


BEGIN
    DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
       table_name          => 'PET',
       format              => json_object('delimiter'value ','),
       column_list         => 'name varchar2(20), gender varchar2(10), salary number',
       partitioning_clause => 'partition by range (salary)
              (   -- Use test1.csv in the DEFAULT DIRECTORY DATA_PUMP_DIR 
                  partition p1 values less than (100) LOCATION (''test1.csv''),
                   -- Use test2.csv in a specified directory MY_DIR
                  partition p2 values less than (300) DEFAULT DIRECTORY MY_DIR LOCATION (''test2.csv'')        )'   );                       
END;                     
/

非構造化データ・ファイルでfile_uri_listおよびcolumn_listパラメータを使用した例:

BEGIN
  DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
   table_name => 'MYSALES',
   credential_name => 'DEF_CRED_NAME',
   file_uri_list     => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/*.csv', 
   column_list       => 'product varchar2(100), units number, country varchar2(100), year number, month varchar2(2)', 
   field_list        => 'product, units', --[Because country, year and month are not in the file, they are not listed in the field list]
   format            => '{"type":"csv", "partition_columns":["country","year","month"]}');
END;
/ 

構造化データ・ファイルでcolumn_listパラメータを指定せずにfile_uri_listを使用した例:

BEGIN
  DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
  table_name => 'MYSALES',
  credential_name => 'DEF_CRED_NAME',
  DBMS_CLOUD.CREATE_EXTERNAL_PART_TABLE(
    table_name      => 'MYSALES',
    credential_name => 'DEF_CRED_NAME',
    file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/*.parquet',
    format          => 
        json_object('type' value 'parquet', 'schema' value 'first',
                    'partition_columns' value 
                          json_array(
                                json_object('name' value 'country', 'type' value 'varchar2(100)'),
                                json_object('name' value 'year', 'type' value 'number'),
                                json_object('name' value 'month', 'type' value 'varchar2(2)')
                          )
         )
    );
END;
/

CREATE_EXTERNAL_TABLEプロシージャ

このプロシージャでは、クラウド内のファイルに基づいて、またはディレクトリ内のファイルから外部表を作成します。これにより、Autonomous Databaseから外部データに対する問合せを実行できます。

構文

DBMS_CLOUD.CREATE_EXTERNAL_TABLE (
    table_name       IN VARCHAR2,
    credential_name  IN VARCHAR2,
    file_uri_list    IN CLOB,
    column_list      IN CLOB,
    field_list       IN CLOB DEFAULT,
    format           IN CLOB DEFAULT);

Parameters

パラメータ 説明

table_name

外部表の名前。

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

file_uri_listでディレクトリまたは表ハイパーリンクURLを指定する場合、このパラメータは使用されません。

file_uri_list

このパラメータでは、ソース・ファイルURIのカンマ区切りリスト、または1つ以上のディレクトリとソース・ファイルを指定します。

クラウド・ソース・ファイルのURI

クラウド・ソース・ファイルURIのファイル名には、ワイルドカードおよび正規表現を使用できます。

正規表現を使用できるのは、regexuri formatパラメータがTRUEに設定されている場合のみです。

regexuriパラメータがFALSEに設定されている場合、文字"*"および"?"はワイルドカード文字とみなされます。regexuriパラメータがTRUEに設定されている場合、文字"*"および"?"は指定された正規表現パターンの一部です。

正規表現パターンは、URI内のファイル名またはサブフォルダ・パスでのみサポートされ、パターン一致はREGEXP_LIKE関数によって実行されるものと同じです。

このオプションは、オブジェクト・ストレージのファイルに作成された外部表でのみサポートされます。

たとえば次のようにします。

file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.csv'

URIのフォーマットは、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

REGEXP_LIKE条件の詳細は、『Oracle Database 19c SQL言語リファレンス』REGEXP_LIKE条件または『Oracle Database 23ai SQL言語リファレンス』を参照してください。

ディレクトリ

1つのディレクトリと1つ以上のファイル名を指定することも、ディレクトリとファイル名のカンマ区切りリストを使用することもできます。ディレクトリを指定する形式は、'MY_DIR:filename.ext'です。デフォルトでは、ディレクトリ名MY_DIRはデータベース・オブジェクトであり、大/小文字は区別されません。ファイル名は、大/小文字が区別されます。

ワイルドカードを使用して、ディレクトリ内のファイル名を指定できます。文字"*"は複数の文字を表すワイルドカードとして、文字"?"は1つの文字を表すワイルドカードとして使用できます。例:'MY_DIR:*"または'MY_DIR:test?'

複数のディレクトリを指定するには、ディレクトリのカンマ区切りリストを使用します。例:'MY_DIR1:*, MY_DIR2:test?'

大/小文字を区別するディレクトリ名を指定するには、二重引用符を使用します。例:'"my_dir1":*, "my_dir2":Test?'

引用符文字を含めるには、2つの引用符を使用します。例:'MY_DIR:''filename.ext'。これは、filenameが引用符(')で始まることを示します。

column_list

外部表の列名およびデータ型のカンマ区切りリスト。

field_list

ソース・ファイル内のフィールドとそのデータ型を識別します。デフォルト値はNULLで、フィールドおよびそのデータ型がcolumn_listパラメータによって決定されることを意味します。この引数の構文は、通常のOracle Database外部表のfield_list句と同じです。field_listの詳細は、『Oracle Database 19cユーティリティ』または『Oracle Database 23aiユーティリティ』field_definitions句のORACLE_LOADERアクセス・ドライバfield_listに関する項を参照してください。

format

ソース・ファイルのフォーマットを説明するオプション。オプションのリストと値の指定方法は、フォーマット・パラメータを参照してください。

Avro、 ORC、 or Parquet形式のファイルについては、Avro、 ORC、 or Parquetファイル用のCREATE_EXTERNAL_TABLEプロシージャを参照してください。

使用上のノート

  • プロシージャDBMS_CLOUD.CREATE_EXTERNAL_TABLEは、Azure Blob Storageを含む、サポートされているクラウド・オブジェクト・ストレージ・サービスの外部パーティション・ファイルをサポートします。

    資格証明は表レベルのプロパティであるため、外部ファイルは同じオブジェクト・ストアに存在する必要があります。

    詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

  • デフォルトのレコード・区切り文字はdetected newlineです。detected newlineを指定すると、DBMS_CLOUDは、レコード・区切り文字として使用する適切な改行文字の自動検出を試行します。DBMS_CLOUDは、最初にWindows改行文字\r\nを検索します。Windows改行文字が見つかった場合、それがプロシージャのすべてのファイルのレコード・デリミタとして使用されます。Windows改行文字が検出されない場合、DBMS_CLOUDでは、UNIX/Linux改行文字\nが検索され、見つかった場合は\nがプロシージャのすべてのファイルのレコード・区切り文字として使用されます。ソース・ファイルで異なるレコード・区切り記号の組合せが使用されている場合は、KUP-04020: found record longer than buffer size supportedなどのエラーが発生する可能性があります。この場合、ソース・ファイルを変更して同じレコード・区切り文字を使用するか、同じレコード・区切り文字を使用するソース・ファイルのみを指定する必要があります。

    recorddelimiterフォーマット・オプションの詳細は、フォーマット・パラメータを参照してください。

BEGIN  
   DBMS_CLOUD.CREATE_EXTERNAL_TABLE(   
      table_name =>'WEATHER_REPORT_DOUBLE_DATE',   
      credential_name =>'OBJ_STORE_CRED',   
      file_uri_list =>'&base_URL/Charlotte_NC_Weather_History_Double_Dates.csv',
      format => json_object('type' value 'csv', 'skipheaders' value '1'),   
      field_list => 'REPORT_DATE DATE''mm/dd/yy'',                   
                     REPORT_DATE_COPY DATE ''yyyy-mm-dd'',
                     ACTUAL_MEAN_TEMP,                 
                     ACTUAL_MIN_TEMP,                 
                     ACTUAL_MAX_TEMP,                 
                     AVERAGE_MIN_TEMP,                    
                     AVERAGE_MAX_TEMP,     
                     AVERAGE_PRECIPITATION',   
      column_list => 'REPORT_DATE DATE,   
                     REPORT_DATE_COPY DATE,
                     ACTUAL_MEAN_TEMP NUMBER,  
                     ACTUAL_MIN_TEMP NUMBER,  
                     ACTUAL_MAX_TEMP NUMBER,  
                     AVERAGE_MIN_TEMP NUMBER,   
                     AVERAGE_MAX_TEMP NUMBER,                  
                     AVERAGE_PRECIPITATION NUMBER');
   END;
/ 

SELECT * FROM WEATHER_REPORT_DOUBLE_DATE where         
   actual_mean_temp > 69 and actual_mean_temp < 74

CREATE_EXTERNAL_TABLE Apache Icebergの手順

このプロシージャは、サポートされている構成でApache Iceberg表の外部表を作成します。

次の特定の構成がサポートされています。

構文

DBMS_CLOUD.CREATE_EXTERNAL_TABLE (
    table_name       IN VARCHAR2,
    credential_name  IN VARCHAR2 DEFAULT NULL,
    file_uri_list    IN CLOB,
    column_list      IN CLOB DEFAULT NULL,
    field_list       IN CLOB DEFAULT NULL,
    format           IN CLOB DEFAULT NULL
);

Parameters

パラメータ 説明

table_name

外部表の名前。

credential_name

データ・ファイル、メタデータ・ファイルおよびIcebergカタログ(使用する場合)へのアクセスに使用される資格証明の名前。

AWSおよびOCI構成の場合、CREATE_CREDENTIALプロシージャの説明に従って資格証明を作成する必要があります。

AWS Amazonリソース名(ARN)資格証明は現在サポートされていません。

file_uri_list

Icebergカタログが指定されている場合は、NULLである必要があります(次のformatパラメータを参照)。氷山カタログを使用しない場合、file_uri_listには氷山メタデータ・ファイルへのURIが含まれている必要があります。

column_list

列名および型はIcebergメタデータから自動的に導出されるため、NULLである必要があります。

列名は、基礎となるデータ・ファイル(Parquet、Avro、ORC)にある名前と一致します。Oracleデータ型は、Icebergデータ型とParquetデータ型、Avroデータ型およびORCデータ型の間のParquet/Avro/ORCマッピングを使用して導出されます。したがって、ユーザーはcolumn_listを指定できません。

field_list

列名およびデータ型はIcebergメタデータから自動的に導出されるため、NULLである必要があります。

format

formatパラメータの構造は、Iceberg表のタイプ、および外部表の作成に使用される情報(データ・カタログや直接メタデータURIからの情報など)によって異なります。

詳細は、OCIデータ・フロー・サンプルでのIcebergのサポートおよびDBMS_CLOUD URI形式を参照してください。

AWS Glue Catalogを使用したAWS Iceberg表のフォーマット・パラメータの例

AWS Glue Catalogを使用してAWS Iceberg表に表を作成する場合のformatパラメータの例を次に示します。

format => json_object('access_protocol' value
       json_object('protocol_type' value 'iceberg',
                   'protocol_config' value
                    json_object('iceberg_catalog_type' value 'aws_glue',
                                'iceberg_glue_region'  value 'glue region',
                                'iceberg_table_path'   value 'database_name.table_name'))); 
ここで、access_protocolパラメータには、次の2つの要素を持つJSONオブジェクトが含まれます。
  • protocol_type: 'iceberg'である必要があります
  • protocol_config: 氷山カタログの詳細を指定するネストされたJSONオブジェクト。
    • iceberg_catalog_type: 'aws_glue'である必要があります。
    • iceberg_glue_region: カタログ・リージョン('us-west-1'など)
    • iceberg_table_path: glue database.glue table nameパス。

メタデータ・ファイルURIを使用したAWS Iceberg表のフォーマット・パラメータの例

メタデータ・ファイルURIを使用してAWS Iceberg表に表を作成する場合のformatパラメータの例を次に示します。
format => json_object('access_protocol' value
       json_object('protocol_type' value 'iceberg')

HadoopCatalogカタログを使用したOCI Iceberg表のフォーマット・パラメータの例

HadoopCatalogカタログを使用してOCIデータ・フローによって作成されたOCI Iceberg表を介して表を作成する場合のサンプルformatパラメータは次のとおりです。
format => json_object('access_protocol' value
       json_object('protocol_type'   value 'iceberg',
                   'protocol_config' value
                   json_object('iceberg_catalog_type'  value 'hadoop',
                               'iceberg_warehouse'     value '<OCI folder URI>',
                               'iceberg_table_path'    value 'database_name.table_name')));
ここで、access_protocolパラメータには、次の2つの要素を持つJSONオブジェクトが含まれます。
  • protocol_type: 'iceberg'である必要があります。
  • protocol_config: 氷山カタログの詳細を指定するネストされたJSONオブジェクト。
    • iceberg_catalog_type: 'hadoop'である必要があります。
    • iceberg_warehouse: 表の生成時に使用されるウェアハウス・ディレクトリ・パス(ネイティブURI形式)。
    • iceberg_table_path: 表の作成時に使用されるdatabase_name.table nameパス。

メタデータ・ファイルのURIを使用したOCI Iceberg表のフォーマット・パラメータの例

メタデータ・ファイルのURIを使用してOCI Iceberg表に表を作成する場合のformatパラメータの例を次に示します。
format => json_object('access_protocol' value
       json_object('protocol_type' value 'iceberg')
ここで、access_protocolパラメータには、次のように1つの要素を持つJSONオブジェクトが含まれます。
  • protocol_type: 'iceberg'である必要があります。

Avro、ORCまたはParquetファイルのCREATE_EXTERNAL_TABLEプロシージャ

このプロシージャは、formatパラメータのtypeを値avroorcまたはparquetに設定することで、クラウドまたはディレクトリ内のAvro、ORCまたはParquet形式のファイルを使用して外部表を作成します。

これにより、Autonomous Databaseから外部データに対する問合せを実行できます。

構文

DBMS_CLOUD.CREATE_EXTERNAL_TABLE (
    table_name       IN VARCHAR2,
    credential_name  IN VARCHAR2 DEFAULT NULL,
    file_uri_list    IN CLOB,
    column_list      IN CLOB,
    field_list       IN CLOB DEFAULT,
    format           IN CLOB DEFAULT);

Parameters

パラメータ 説明

table_name

外部表の名前。

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

file_uri_listでディレクトリを指定する場合、このパラメータは使用されません。

file_uri_list

このパラメータでは、ソース・ファイルURIのカンマ区切りリスト、または1つ以上のディレクトリとソース・ファイルを指定します。

クラウド・ソース・ファイルのURI

クラウド・ソース・ファイルURIのファイル名には、ワイルドカードおよび正規表現を使用できます。

正規表現を使用できるのは、regexuri formatパラメータがTRUEに設定されている場合のみです。

regexuriパラメータがFALSEに設定されている場合、文字"*"および"?"はワイルドカード文字とみなされます。regexuriパラメータがTRUEに設定されている場合、文字"*"および"?"は指定された正規表現パターンの一部です。

正規表現パターンは、URI内のファイル名またはサブフォルダ・パスでのみサポートされ、パターン一致はREGEXP_LIKE関数によって実行されるものと同じです。

このオプションは、オブジェクト・ストレージのファイルに作成された外部表でのみサポートされます。

たとえば次のようにします。

file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.parquet'

URIのフォーマットは、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

REGEXP_LIKE条件の詳細は、『Oracle Database 19c SQL言語リファレンス』REGEXP_LIKE条件または『Oracle Database 23ai SQL言語リファレンス』を参照してください。

ディレクトリ

1つのディレクトリと1つ以上のファイル名を指定することも、ディレクトリとファイル名のカンマ区切りリストを使用することもできます。ディレクトリを指定する形式は、'MY_DIR:filename.ext'です。デフォルトでは、ディレクトリ名MY_DIRはデータベース・オブジェクトであり、大/小文字は区別されません。ファイル名は、大/小文字が区別されます。

ワイルドカードを使用して、ディレクトリ内のファイル名を指定できます。文字"*"は複数の文字を表すワイルドカードとして、文字"?"は1つの文字を表すワイルドカードとして使用できます。例:'MY_DIR:*"または'MY_DIR:test?'

複数のディレクトリを指定するには、ディレクトリのカンマ区切りリストを使用します。例:'MY_DIR1:*, MY_DIR2:test?'

大/小文字を区別するディレクトリ名を指定するには、二重引用符を使用します。例:'"my_dir1":*, "my_dir2":Test?'

引用符文字を含めるには、2つの引用符を使用します。例:'MY_DIR:''filename.ext'。これは、filenameが引用符(')で始まることを示します。

column_list

(オプション)このフィールドは、指定されると、スキーマ、列およびデータ型の自動導出を指定するformat->schemaパラメータをオーバーライドします。詳細は、formatパラメータを参照してください。

Avro、 ORC、 or Parquetソースに対してcolumn_listを指定する場合、列名は、ファイルにあるそれらの列と一致している必要があります。Oracleデータ型は、Avro、ORCまたはParquetデータ型に適切にマップされる必要があります。

Parquetファイルの詳細は、DBMS_CLOUDパッケージのParquetとOracleデータ型のマッピングを参照してください。

ORCファイルの詳細は、DBMS_CLOUDパッケージのORCとOracleデータ型のマッピングを参照してください。

Avroファイルの詳細は、DBMS_CLOUDパッケージのAvroからOracleデータ型へのマッピングを参照してください。

field_list

Avro、ORCまたはParquetファイルでは無視されます。

ソースのフィールドは、名前で外部表の列を照合します。ソースのデータ型は外部表の列データ型に変換されます。

ORCファイルについては、DBMS_CLOUDパッケージのORCからOracleデータ型へのマッピングを参照してください

Parquetファイルの詳細は、DBMS_CLOUDパッケージのParquetとOracleデータ型のマッピングを参照してください。

Avroファイルの詳細は、DBMS_CLOUDパッケージのAvroからOracleデータ型へのマッピングを参照してください。

format

Avro、ORCまたはParquet typeソース・ファイルについては、DBMS_CLOUD Avro、ORCまたはParquet用のパッケージ・フォーマット・オプションを参照してください。

ORCの例

format => '{"type":"orc", "schema": "all"}'
format => json_object('type' value 'orc', 'schema' value 'first')

Avroの例

format => '{"type":"avro", "schema": "all"}'
format => json_object('type' value 'avro', 'schema' value 'first')

Parquetの例

format => '{"type":"parquet", "schema": "all"}'
format => json_object('type' value 'parquet', 'schema' value 'first')

Avro、 ORC、 or Parquet列名のOracle列名へのマッピング

Oracle SQLでの列名マッピングおよび列名変換の使用方法の詳細は、DBMS_CLOUDパッケージAvro、ORCおよびParquetからOracle列名へのマッピングを参照してください。

CREATE_EXTERNAL_TEXT_INDEXプロシージャ

このプロシージャは、オブジェクト・ストレージ・ファイルにテキスト索引を作成します。

CREATE_EXTERNAL_TEXT_INDEXプロシージャは、location_uriの場所で指定されたオブジェクト・ストレージ・ファイルにテキスト索引を作成します。場所URI上のファイルを使用して行われた新しい追加または削除に対して、索引は定期的にリフレッシュされます。

構文

DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX (
      credential_name  IN  VARCHAR2 DEFAULT NULL,
      location_uri     IN  VARCHAR2,
      index_name       IN  VARCHAR2,
      format           IN  CLOB     DEFAULT NULL
);

Parameters

パラメータ 説明

credential_name

Cloud Object Storageの場所にアクセスするための資格証明の名前。パブリック、事前認証済または事前署名済バケットURIの場合、NULLを指定できます。

credential_name値を指定しない場合、credential_nameNULL値に設定されます。

location_uri

オブジェクト・ストア・バケットまたはフォルダURIを指定します。

このパラメータは必須です。

URIのフォーマットは、クラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、DBMS_CLOUDパッケージ・ファイル・クラウドのオブジェクト・ストレージのURI形式を参照してください。

index_name location_uriの場所にあるファイル上に構築する索引の名前を指定します。

このパラメータは必須です。

format

追加の構成オプションを指定します。オプションはJSON文字列として指定されます。

サポートされている形式オプションは次のとおりです。

refresh_rate: ローカル索引がリフレッシュされる頻度を分単位で指定します。新しいファイルのアップロードと削除により、索引がリフレッシュされます。デフォルト値は5分です。

binary_files: 索引付けするファイルの内容がバイナリかどうかを指定します。たとえば、PDF、MS-Wordの場合、デフォルト値はFALSEです。

stop_words: 索引の作成時に指定できるストップ・ワードのリストを指定します。

stop_words値は、それがストップ・ワードのリストであるか、ストップ・ワードの表であるかを示します。JSON配列にストップ・ワード・パラメータが指定されている場合、それはリストとして扱われます。それ以外の場合、ストップ・ワード・パラメータは、ストップ・ワードのリストで読み取るために列"STOP_WORDS"が使用される表名として扱われます。

次の方法でストップワードを指定できます。

  • JSON配列: 例: format := '{"stop_words":["king","queen"]}'
  • ストップ・ワード表名: たとえば: format := '{"stop_words":"STOP_WORDS_TABLE"}'

formatパラメータを指定しない場合、formatNULL値に設定されます。

BEGIN 
DBMS_CLOUD.CREATE_EXTERNAL_TEXT_INDEX (
        credential_name => 'DEFAULT_CREDENTIAL',
        location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/ts_data/'
        index_name      => 'EMP',
        format          => JSON_OBJECT ('refresh_rate' value 10)
);
END;
/

CREATE_HYBRID_PART_TABLEプロシージャ

このプロシージャでは、ハイブリッド・パーティション表を作成します。これにより、クラウドのデータベース・オブジェクトおよびファイル、またはディレクトリ内のデータベース・オブジェクトおよびファイルを使用して、Autonomous Databaseのハイブリッド・パーティション・データに対して問合せを実行できます。

構文

DBMS_CLOUD.CREATE_HYBRID_PART_TABLE (
    table_name           IN VARCHAR2,
    credential_name      IN VARCHAR2,
    partitioning_clause  IN CLOB,
    column_list          IN CLOB,
    field_list           IN CLOB DEFAULT,
    format               IN CLOB DEFAULT);

Parameters

パラメータ 説明

table_name

外部表の名前。

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

partitioning_clause

個々のパーティションの場所情報を含む完全なパーティション化句を指定します。

ディレクトリを使用するには、パーティション化句でLOCATIONおよびDEFAULT DIRECTORYの値がサポートされます。

クラウド・ソース・ファイルURIのファイル名には、ワイルドカードおよび正規表現を使用できます。

正規表現を使用できるのは、regexuri formatパラメータがTRUEに設定されている場合のみです。

regexuriパラメータがFALSEに設定されている場合、文字"*"および"?"はワイルドカード文字とみなされます。regexuriパラメータがTRUEに設定されている場合、文字"*"および"?"は指定された正規表現パターンの一部です。

正規表現パターンは、URI内のファイル名またはサブフォルダ・パスでのみサポートされ、パターン一致はREGEXP_LIKE関数によって実行されるものと同じです。ディレクトリ名では正規表現パターンはサポートされていません。

たとえば次のようにします。

partitioning_clause => 'partition by range (col1)
                                (partition p1 values less than (1000) external location
				    ( ''https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o(/)*year=[0-9]+(/)*month=[0-9]+(/)*[a-z]+[1-3]??.txt''),….

REGEXP_LIKE条件の詳細は、『Oracle Database 19c SQL言語リファレンス』REGEXP_LIKE条件または『Oracle Database 23ai SQL言語リファレンス』を参照してください。

column_list

外部表の列名およびデータ型のカンマ区切りリスト。

field_list

ソース・ファイル内のフィールドとそのデータ型を識別します。デフォルト値はNULLで、フィールドおよびそのデータ型がcolumn_listパラメータによって決定されることを意味します。この引数の構文は、通常のOracle外部表のfield_list句と同じです。詳細は、Oracle Database 19cユーティリティまたはOracle Database 23aiユーティリティfield_listを参照してください。

format

ソース・ファイルのフォーマットを説明するオプション。オプションのリストと値の指定方法は、フォーマット・パラメータを参照してください。

使用上のノート

  • プロシージャDBMS_CLOUD.CREATE_HYBRID_PART_TABLEは、Azure Blob Storageを含むサポートされているクラウド・オブジェクト・ストレージ・サービスの外部パーティション・ファイルをサポートします。

    資格証明は表レベルのプロパティであるため、外部ファイルは同じオブジェクト・ストアに存在する必要があります。

    詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

  • プロシージャDBMS_CLOUD.CREATE_HYBRID_PART_TABLEは、ローカル・ファイル・システムまたはネットワーク・ファイル・システム内のディレクトリ内のハイブリッド・パーティション・ファイルをサポートします。

  • DBMS_CLOUD.CREATE_HYBRID_PART_TABLEを使用して作成する外部パーティション表には、2つの非表示列file$pathおよびfile$nameが含まれます。これらの列は、レコードの取得元ファイルの識別に役立ちます。

    • file$path: オブジェクト名の先頭までのファイル・パス・テキストを指定します。

    • file$name: バケット名に続くすべてのテキストを含め、オブジェクト名を指定します。

BEGIN  
   DBMS_CLOUD.CREATE_HYBRID_PART_TABLE(
      table_name =>'HPT1',  
      credential_name =>'OBJ_STORE_CRED',  
      format => json_object('delimiter' value ',', 'recorddelimiter' value 'newline', 'characterset' value 'us7ascii'),  
      column_list => 'col1 number, col2 number, col3 number',
      partitioning_clause => 'partition by range (col1)
                                (partition p1 values less than (1000) external location
                                    ( ''&base_URL/file_11.txt'')
                                 ,
                                 partition p2 values less than (2000) external location
                                    ( ''&base_URL/file_21.txt'')
                                 ,
                                 partition p3 values less than (3000)
                                 )'
     );
   END;
/ 


BEGIN
   DBMS_CLOUD.CREATE_HYBRID_PART_TABLE(
    table_name  => 'HPT1',
    format      => json_object('delimiter'value ',', 'recorddelimiter'value 'newline'),
    column_list => 'NAME VARCHAR2(30), GENDER VARCHAR2(10), BALANCE number',
    partitioning_clause => 'partition by range (B  2  ALANCE)
               (partition p1 values less than (1000) external DEFAULT DIRECTORY DATA_PUMP_DIR LOCATION (''Scott_male_1000.csv''),
                partition p2 values less than (2000) external DEFAULT DIRECTORY DATA_PUMP_DIR LOCATION (''Mary_female_3000.csv''),
                partition p3 values less than (3000))' );
END;
/

DELETE_ALL_OPERATIONSプロシージャ

このプロシージャは、スキーマ内のuser_load_operations表に記録されたすべてのデータ・ロード操作をクリアするか、typeパラメータで示されている、指定されたタイプのすべてのデータ・ロード操作をクリアします。

構文

DBMS_CLOUD.DELETE_ALL_OPERATIONS (
	type      IN VARCHAR DEFAULT NULL);

Parameters

パラメータ 説明

type

削除する操作のタイプを指定します。タイプの値は、user_load_operations表のTYPE列にあります。

typeが指定されていない場合、すべての行が削除されます。

使用上のノート

  • DBMS_CLOUD.DELETE_ALL_OPERATIONSは、現在実行中の操作(ステータスが「実行中」の操作)は削除しません。

DELETE_FILEプロシージャ

このプロシージャは、Autonomous Database上の指定されたディレクトリから指定されたファイルを削除します。

構文

 DBMS_CLOUD.DELETE_FILE ( 
       directory_name     IN VARCHAR2,
       file_name          IN VARCHAR2,
       force              IN BOOLEAN DEFAULT FALSE); 

Parameters

パラメータ 説明

directory_name

Autonomous Databaseインスタンスのディレクトリの名前。

file_name

削除するファイルの名前。

force

ファイルが存在しない場合、エラーを無視して報告しません。有効な値は、TRUEおよびFALSEです。デフォルト値はFALSEです。

ノート:

DBMS_CLOUD.DELETE_FILEをADMIN以外のユーザーで実行するには、ファイルを含むディレクトリに対する書込み権限をそのユーザーに付与する必要があります。たとえば、atpc_userに書込み権限を付与する場合は、ADMINとして次のコマンドを実行します:
GRANT WRITE ON DIRECTORY data_pump_dir TO atpc_user;

BEGIN
   DBMS_CLOUD.DELETE_FILE(
      directory_name =>  'DATA_PUMP_DIR',
      file_name => 'exp1.dmp' );
   END;
/ 

DELETE_OBJECTプロシージャ

このプロシージャは、オブジェクト・ストアの指定されたオブジェクトを削除します。

構文

DBMS_CLOUD.DELETE_OBJECT (
       credential_name      IN VARCHAR2,
       object_uri           IN VARCHAR2,
       force                IN BOOLEAN DEFAULT FALSE);

Parameters

パラメータ 説明

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

object_uri

削除するオブジェクトのオブジェクトまたはファイルURI。URIのフォーマットは、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

force

オブジェクトが存在しない場合、エラーを無視して報告しません。有効な値は、TRUEおよびFALSEです。デフォルト値はFALSEです。

BEGIN
   DBMS_CLOUD.DELETE_OBJECT(
       credential_name => 'DEF_CRED_NAME',
       object_uri => 'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucketname/o/exp1.dmp' );
   END;
/ 

DELETE_OPERATIONプロシージャ

このプロシージャは、スキーマのuser_load_operationsまたはdba_load_operations表に記録された、指定された操作IDのデータ・ロード・エントリをクリアします。

構文

DBMS_CLOUD.DELETE_OPERATION (
	id      IN NUMBER);

Parameters

パラメータ 説明

id

削除するログ・ファイル・エントリに関連付けられた操作IDを指定します。

SELECT id FROM user_load_operations WHERE type LIKE '%BAD%';
EXEC DBMS_CLOUD.DELETE_OPERATION(id);

DROP_EXTERNAL_TEXT_INDEXプロシージャ

このプロシージャは、オブジェクト・ストレージ・ファイルのテキスト索引を削除します。

DROP_EXTERNAL_TEXT_INDEXプロシージャは、CREATE_EXTERNAL_TEXT_INDEXプロシージャで作成された指定された索引を削除します。

構文

DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX (
      index_name       IN  VARCHAR2,
);

Parameters

パラメータ 説明
index_name

削除する索引の名前を指定します。

索引名は、索引の作成時に指定された名前と一致する必要があります。

このパラメータは必須です。

BEGIN 
DBMS_CLOUD.DROP_EXTERNAL_TEXT_INDEX (
        index_name => 'EMP',
);
END;
/

EXPORT_DATAプロシージャ

このプロシージャは、問合せの結果に基づいてAutonomous Databaseからデータをエクスポートします。この手順はオーバーロードされており、クラウドまたはディレクトリへのファイルの書込みをサポートしています。

format typeパラメータに基づいて、プロシージャはファイルをクラウドにエクスポートするか、CSV、JSON、ParquetまたはXML形式のテキスト・ファイルとしてディレクトリの場所にエクスポートします。

構文

DBMS_CLOUD.EXPORT_DATA (
      credential_name   IN VARCHAR2 DEFAULT NULL,
      file_uri_list     IN CLOB,
      format            IN CLOB,
      query             IN CLOB);

DBMS_CLOUD.EXPORT_DATA (
      credential_name   IN VARCHAR2 DEFAULT NULL,
      file_uri_list     IN CLOB DEFAULT NULL,
      format            IN CLOB DEFAULT NULL,
      query             IN CLOB DEFAULT NULL,
      operation_id      OUT NOCOPY NUMBER);

Parameters

パラメータ 説明

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

資格証明パラメータが含まれていない場合、ディレクトリへの出力を指定します。

file_uri_list

formatパラメータの値、および資格証明パラメータを含めるかどうかに応じて、様々なフォームがあります:
  • formatパラメータのtype値がjsonの場合: オブジェクト・ストア上のJSONまたは指定されたディレクトリの場所へのJSONは、file_uri_listパラメータの値に基づいて生成されたファイル名で保存されます。詳細は、テキスト出力(CSV、JSON、ParquetまたはXML)のファイル・ネーミングを参照してください。

  • formatパラメータのtype値がdatapumpの場合、file_uri_listはダンプ・ファイルのカンマ区切りリストです。これは、オブジェクト・ストアで作成するファイルを指定します。file_uri_listでは、ワイルドカードや置換文字の使用はサポートされていません。

  • credential_nameパラメータを指定しない場合は、file_uri_listにディレクトリ名を指定します。

URIのフォーマットは、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

format

エクスポート・フォーマット・オプションを提供するJSON文字列。

サポートされるオプションは次のとおりです。

  • type: type formatオプションは必須であり、csv | datapump | json | parquet | xmlのいずれかの値が必要です。

DBMS_CLOUD Package Format Options for EXPORT_DATAを参照してください。

query

このパラメータを使用して、必要なデータのみがエクスポートされるようにSELECT文を指定します。問合せによって、テキスト・ファイルCSV、JSON、ParquetまたはXMLとして、またはダンプ・ファイルとしてエクスポートするファイルのコンテンツが決定されます。たとえば次のようにします。

SELECT warehouse_id, quantity FROM inventories

format type値がjsonの場合、各問合せ結果がチェックされ、関数JSON_OBJECT_T.parse()で決定されたJSONでない場合は、DBMS_CLOUD.EXPORT_DATAによって問合せがJSON_OBJECT関数を含むように変換され、行がJSONに変換されます。詳細は、Oracle Database 19c SQL言語リファレンスJSON_OBJECT、またはOracle Database 23ai SQL言語リファレンスJSON_OBJECT_Tオブジェクト・タイプOracle Database 19c PL/SQLパッケージおよびタイプ・リファレンスまたはOracle Database 23ai PL/SQLパッケージおよびタイプ・リファレンスを参照してください。

たとえば次のようにします。

SELECT JSON_OBJECT(* RETURNING CLOB) from(SELECT warehouse_id, quantity FROM inventories)

operation_id

このパラメータを使用して、エクスポート操作の進行状況および最終ステータスをUSER_LOAD_OPERATIONSビュー内の対応するIDとしてトラッキングします。

使用上のノート:

  • 指定するqueryパラメータ値は、必要に応じて、結合や副問合せを含む問合せなどの拡張問合せにすることができます。

  • 指定されたフォーマット・パラメータに応じて、DBMS_CLOUD.EXPORT_DATAは、指定された問合せの結果をクラウド・オブジェクト・ストアまたはCSV、JSON、ParquetまたはXMLファイル形式のディレクトリの場所に出力します。

    CSV、JSON、ParquetまたはXML出力ファイルでのDBMS_CLOUD.EXPORT_DATAの使用の詳細は、DBMS_CLOUD.EXPORT_DATAを使用したテキストとしてのオブジェクト・ストアへのデータのエクスポートおよびDBMS_CLOUD.EXPORT_DATAを使用したディレクトリへのデータのエクスポートを参照してください。

  • CSV、JSONまたはXML出力の場合、生成されるファイルに10MBのデータが含まれると、デフォルトで新しい出力ファイルが作成されます。ただし、結果データが10MB未満の場合でも、データベース・サービスや、Autonomous DatabaseインスタンスのECPU (OCPUを使用している場合)の数によっては、複数の出力ファイルが作成される可能性があります。

    詳細は、テキスト出力(CSV、JSON、ParquetまたはXML)のファイル・ネーミングを参照してください。

    CSV、JSONまたはXMLのデフォルトの出力ファイルのチャンク・サイズは10MBです。この値は、formatパラメータのmaxfilesizeオプションを使用して変更できます。詳細は、DBMS_CLOUD Package Format Options for EXPORT_DATAを参照してください。

  • Parquet出力の場合、生成される各ファイルは128MB未満で、複数の出力ファイルが生成される可能性があります。ただし、結果データが128MB未満の場合でも、データベース・サービスおよびAutonomous DatabaseインスタンスのECPU (OCPUを使用している場合)の数によっては、複数の出力ファイルが作成される可能性があります。

    詳細は、テキスト出力(CSV、JSON、ParquetまたはXML)のファイル・ネーミングを参照してください。

  • parquet出力形式は、専用Exadataインフラストラクチャ上のAutonomous Databaseの高中データベース・サービスでのみ使用できます。

ディレクトリへの出力でのDBMS_CLOUD.EXPORT_DATAの使用上のノート

  • 指定されたディレクトリが存在している必要があり、ADMINユーザーとしてログインしているか、ディレクトリへのWRITEアクセス権を持っている必要があります。

  • DBMS_CLOUD.EXPORT_DATAはディレクトリを作成しません。

  • ファイルは上書きしません。たとえば、file_uri_listのダンプ・ファイルが存在する場合、DBMS_CLOUD.EXPORT_DATAは、次のようなエラーを報告します。

    ORA-31641: unable to create dump file  "/u02/exports/123.dmp"
    ORA-27038: created file already exists

次の例は、formatのtypeパラメータに値jsonが指定されたDBMS_CLOUD.EXPORT_DATAを示しています:

BEGIN  
   DBMS_CLOUD.EXPORT_DATA(
      credential_name => 'OBJ_STORE_CRED',
      file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/exp1.json', 
      query           => 'SELECT * FROM DEPT',
      format          => JSON_OBJECT('type' value 'json', 'compression' value 'gzip'));
     );
   END;
/  

次の例は、formatのtypeパラメータに値xmlが指定されたDBMS_CLOUD.EXPORT_DATAを示しています:

BEGIN  
   DBMS_CLOUD.EXPORT_DATA(
      credential_name => 'OBJ_STORE_CRED',
      file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/exp1.xml', 
      query           => 'SELECT * FROM DEPT',
      format          => JSON_OBJECT('type' value 'xml', 'compression' value 'gzip'));
     );
   END;
/

次の例は、formatのtypeパラメータに値csvが指定されたDBMS_CLOUD.EXPORT_DATAを示しています:

BEGIN  
   DBMS_CLOUD.EXPORT_DATA(
      credential_name => 'OBJ_STORE_CRED',
      file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/exp.csv', 
      query           => 'SELECT * FROM DEPT',
      format          => JSON_OBJECT('type' value 'csv', 'delimiter' value '|', 'compression' value 'gzip', 'header' value true ));
     );
   END;
/  

GET_OBJECTプロシージャおよびファンクション

このプロシージャはオーバーロードされています。このプロシージャ・フォームは、Cloud Object Storageからオブジェクトを読み取り、Autonomous Databaseにコピーします。このファンクション・フォームは、Cloud Object Storageからオブジェクトを読み取り、BLOBAutonomous Databaseに返します。

構文

DBMS_CLOUD.GET_OBJECT (
       credential_name      IN VARCHAR2,
       object_uri           IN VARCHAR2,
       directory_name       IN VARCHAR2,
       file_name            IN VARCHAR2 DEFAULT  NULL,
       startoffset          IN NUMBER DEFAULT  0,
       endoffset            IN NUMBER DEFAULT  0,
       compression          IN VARCHAR2 DEFAULT  NULL);


DBMS_CLOUD.GET_OBJECT(
       credential_name      IN VARCHAR2 DEFAULT NULL,
       object_uri           IN VARCHAR2,
       startoffset          IN NUMBER DEFAULT  0,
       endoffset            IN NUMBER DEFAULT  0,
       compression          IN VARCHAR2 DEFAULT  NULL)
RETURN BLOB;

Parameters

パラメータ 説明

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

object_uri

オブジェクトまたはファイルURI。URIのフォーマットは、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

directory_name

データベース上のディレクトリの名前。

脚注1

file_name

作成するファイルの名前を指定します。ファイル名を指定しない場合、ファイル名はobject_uriパラメータの最後のスラッシュの後から取得されます。たとえば、ファイル名にスラッシュが含まれるような特殊なケースでは、file_nameパラメータを使用してください。

startoffset

プロシージャが読取りを開始するオフセット(バイト)。

endoffset

プロシージャが読取りを停止するオフセット(バイト)。

compression

オブジェクトの格納に使用する圧縮を指定します。compression'AUTO'に設定されている場合、ファイルは圧縮解除されます(値'AUTO'は、object_uriで指定されたオブジェクトがGzipで圧縮されることを示します)。

脚注1

ノート:

ADMIN以外のユーザーでDBMS_CLOUD.GET_OBJECTを実行するには、そのユーザーにディレクトリに対するWRITE権限を付与する必要があります。たとえば、atpc_userに書込み権限を付与する場合は、ADMINとして次のコマンドを実行します:

GRANT WRITE ON DIRECTORY data_pump_dir TO atpc_user;

戻り値

ファンクション形式では、オブジェクト・ストアから読み取り、DBMS_CLOUD.GET_OBJECTBLOBを戻します。

BEGIN 
   DBMS_CLOUD.GET_OBJECT(
     credential_name => 'OBJ_STORE_CRED',
     object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/file.txt',
     directory_name => 'DATA_PUMP_DIR'); 
END;
/

オブジェクト・ストア内のファイルから文字データを読み取るには:

SELECT to_clob(
     DBMS_CLOUD.GET_OBJECT(
       credential_name => 'OBJ_STORE_CRED',
       object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/file.txt'))
FROM DUAL;

データベースのBLOBのオブジェクト・ストアに格納されているイメージを追加するには:


DECLARE
   l_blob BLOB := NULL;
BEGIN
   l_blob := DBMS_CLOUD.GET_OBJECT(
     credential_name => 'OBJ_STORE_CRED',
     object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/MyImage.gif' );
END;
/

この例では、namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。

LIST_FILESファンクション

このファンクションは、指定されたディレクトリ内のファイルを一覧表示します。結果には、ファイル名と、ファイルに関する追加のメタデータ(ファイル・サイズ(バイト)、作成タイムスタンプ、最終変更タイムスタンプなど)が含まれます。

構文

DBMS_CLOUD.LIST_FILES (
	directory_name      IN VARCHAR2)
       RETURN TABLE;

Parameters

パラメータ 説明

directory_name

データベース上のディレクトリの名前。

使用上のノート

  • ADMIN以外のユーザーでDBMS_CLOUD.LIST_FILESを実行するには、そのユーザーにそのディレクトリに対する読取り権限を付与する必要があります。たとえば、atpc_userに読取り権限を付与する場合は、ADMINとして次のコマンドを実行します:

    GRANT READ ON DIRECTORY data_pump_dir TO atpc_user;
  • これは、戻り値のタイプがDBMS_CLOUD_TYPES.list_object_ret_tであるパイプライン・テーブル・ファンクションです。

  • DBMS_CLOUD.LIST_FILESはチェックサム値を取得せず、このフィールドに対してNULLを返します。

これはパイプライン関数で、各ファイルの行を返します。たとえば、次の問合せを使用してこのファンクションを使用します:

SELECT * FROM DBMS_CLOUD.LIST_FILES('DATA_PUMP_DIR');

OBJECT_NAME       BYTES   CHECKSUM      CREATED              LAST_MODIFIED
------------ ---------- ----------    ---------------------  ---------------------
cwallet.sso        2965               2018-12-12T18:10:47Z   2019-11-23T06:36:54Z

LIST_OBJECTSファンクション

このファンクションは、オブジェクト・ストアの指定された場所にあるオブジェクトを一覧表示します。結果には、オブジェクト名と、オブジェクトに関する追加のメタデータ(サイズ、チェックサム、作成タイムスタンプ、最終変更タイムスタンプなど)が含まれます。

構文

DBMS_CLOUD.LIST_OBJECTS (
       credential_name      IN VARCHAR2,
       location_uri         IN VARCHAR2)
   RETURN TABLE;

Parameters

パラメータ 説明

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

location_uri

オブジェクトまたはファイルURI。URIのフォーマットは、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

使用上のノート

  • オブジェクト・ストアの機能によっては、DBMS_CLOUD.LIST_OBJECTSが特定の属性の値を返さないことがあります。その場合、フィールドの戻り値はNULLです。

    サポートされているすべてのオブジェクト・ストアが、OBJECT_NAMEBYTESおよびCHECKSUMフィールドの値を返します。

    次の表に、オブジェクト・ストアごとのフィールドCREATEDおよびLAST_MODIFIEDのサポートを示します:

    オブジェクト・ストア CREATED LAST_MODIFIED
    Oracle Cloud Infrastructureネイティブ タイムスタンプを戻します タイムスタンプを戻します
    Oracle Cloud Infrastructure Swift NULLを返します タイムスタンプを返します
    Amazon S3 NULLを返します タイムスタンプを返します
    Amazon S3互換 NULLを返します タイムスタンプを返します
    Azure タイムスタンプを返します タイムスタンプを返します
  • チェックサム値は、MD5チェックサムです。これは、オブジェクトの内容に基づいて計算されます。

  • これは、戻り値のタイプがDBMS_CLOUD_TYPES.list_object_ret_tであるパイプライン・テーブル・ファンクションです。

これは、オブジェクトごとの行を返すパイプライン関数です。たとえば、次の問合せを使用してこのファンクションを使用します:

SELECT * FROM DBMS_CLOUD.LIST_OBJECTS('OBJ_STORE_CRED', 
    'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/');


OBJECT_NAME   BYTES              CHECKSUM                       CREATED         LAST_MODIFIED
------------ ---------- -------------------------------- --------------------- --------------------
cwallet.sso   2965      2339a2731ba24a837b26d344d643dc07 2019-11-23T06:36:54Z          

この例では、namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。

MOVE_OBJECTプロシージャ

このプロシージャは、あるクラウド・オブジェクト・ストレージ・バケットまたはフォルダから別のクラウド・オブジェクト・ストレージ・バケットにオブジェクトを移動します。

ソース・バケットまたはターゲット・フォルダは、同じクラウド・オブジェクト・ストア・プロバイダまたは異なるクラウド・オブジェクト・ストア・プロバイダに配置できます。

ソースとターゲットが個別のオブジェクト・ストアにある場合、または同じクラウド・プロバイダを持つ異なるアカウントがある場合、ソースとターゲットの場所に個別の資格証明名を指定できます。

ターゲット資格証明名が指定されていない場合、ソース資格証明名はターゲットの場所でもデフォルトで使用されます。

構文

DBMS_CLOUD.MOVE_OBJECT (
    source_credential_name  IN  VARCHAR2 DEFAULT NULL,
    source_object_uri       IN  VARCHAR2,
    target_object_uri       IN  VARCHAR2,
    target_credential_name  IN  VARCHAR2 DEFAULT NULL
);

Parameters

パラメータ 説明

source_credential_name

ソースのCloud Object Storageにアクセスするための資格証明の名前。

source_credential_name値を指定しない場合、credential_nameNULLに設定されます。

source_object_uri

ソース・オブジェクト・ストレージ・バケットまたはフォルダの場所を指すURIを指定します。

このパラメータは必須です。

URIのフォーマットは、クラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

target_object_uri

ファイルの移動が必要なターゲット・オブジェクト・ストレージ・バケットまたはフォルダのURIを指定します。

このパラメータは必須です。

URIのフォーマットは、クラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

target_credential_name

ターゲットのCloud Object Storageの場所にアクセスするための資格証明の名前。

target_credential_name値を指定しない場合、target_object_urisource_credential_name値に設定されます。

BEGIN 
DBMS_CLOUD.MOVE_OBJECT (
    source_credential_name => 'OCI_CRED',
    source_object_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname1/bgfile.csv',
    target_object_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname2/myfile.csv'
);
END;
/

PUT_OBJECTプロシージャ

このプロシージャはオーバーロードされています。ある形式では、このプロシージャはファイルをAutonomous DatabaseからCloud Object Storageにコピーします。別の形式では、Autonomous Databaseからクラウド・オブジェクト・ストレージにBLOBをコピーします。

構文

DBMS_CLOUD.PUT_OBJECT (
       credential_name      IN VARCHAR2,
       object_uri           IN VARCHAR2,
       directory_name       IN VARCHAR2,
       file_name            IN VARCHAR2
       compression          IN VARCHAR2 DEFAULT  NULL);


DBMS_CLOUD.PUT_OBJECT (
       credential_name      IN VARCHAR2,
       object_uri           IN VARCHAR2,
       contents             IN BLOB
       compression          IN VARCHAR2 DEFAULT  NULL);

Parameters

パラメータ 説明

credential_name

クラウド・オブジェクト・ストレージにアクセスするための資格証明の名前。

object_uri

オブジェクトまたはファイルURI。URIのフォーマットは、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります。詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

directory_name

Autonomous Database上のディレクトリの名前。

脚注1

contents

Autonomous Databaseからクラウド・オブジェクト・ストレージにコピーするBLOBを指定します。

file_name

指定されたディレクトリ内のファイルの名前。

compression

オブジェクトの格納に使用する圧縮を指定します。

デフォルト値: NULL

脚注1

ノート:

ADMIN以外のユーザーでDBMS_CLOUD.PUT_OBJECTを実行するには、そのユーザーにディレクトリに対する読取り権限を付与する必要があります。たとえば、atpc_userに読取り権限を付与する場合は、ADMINとして次のコマンドを実行します:

GRANT READ ON DIRECTORY data_pump_dir TO atpc_user;

データベース内処理後にBLOBデータを処理して、そのデータをオブジェクト・ストアのファイルに直接格納するには:

DECLARE
      my_blob_data BLOB;
BEGIN 
 /* Some processing producing BLOB data and populating my_blob_data */
DBMS_CLOUD.PUT_OBJECT(
     credential_name => 'OBJ_STORE_CRED',
     object_uri => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/my_new_file',
     contents => my_blob_data)); 
END;
/

使用上のノート

クラウド・オブジェクト・ストレージに応じて、転送するオブジェクトのサイズは次のように制限されます:

クラウド・オブジェクト・ストレージ・サービス オブジェクト転送のサイズ制限値

Oracle Cloud Infrastructure Object Storage

50GB

Amazon S3

5GB

Azure Blob Storage

256MB

Amazon S3互換

オブジェクト・ストア・プロバイダによって設定されます。詳細は、プロバイダのドキュメントを参照してください。

Oracle Cloud Infrastructureオブジェクト・ストアでは、資格証明を指定せずにファイルをパブリック・バケットに書き込むことはできません(Oracle Cloud Infrastructureでは、ユーザーはパブリック・バケットからオブジェクトをダウンロードできます)。したがって、PUT_OBJECTを使用してオブジェクトをOracle Cloud Infrastructureパブリック・バケットに格納するには、有効な資格証明を含む資格証明名を指定する必要があります。

詳細は、クラウド・オブジェクト・ストレージのURIフォーマットを参照してください。

SYNC_EXTERNAL_PART_TABLEプロシージャ

このプロシージャは、クラウドのファイルの外部パーティション表の更新を簡略化します。このプロシージャは、新しいパーティションが追加されたとき、またはパーティションが外部パーティション表のオブジェクト・ストア・ソースから削除されたときに実行します。

構文

DBMS_CLOUD.SYNC_EXTERNAL_PART_TABLE (
	table_name        IN VARCHAR2,
	schema_name       IN VARCHAR2 DEFAULT,
	update_columns    IN BOOLEAN DEFAULT);

Parameters

パラメータ 説明

table_name

ターゲット表の名前。DBMS_CLOUD.SYNC_EXTERNAL_PART_TABLEを実行する前にターゲット表を作成する必要があります。

schema_name

ターゲット表が存在するスキーマの名前。デフォルト値はNULLで、ターゲット表がプロシージャを実行しているユーザーと同じスキーマ内に存在することを意味します。

update_columns

新しいファイルによってスキーマに変更を取り込むことができます。サポートされる更新には、新しい列や削除された列が含まれます。データ型の変更など、既存の列に対する更新ではエラーがスローされます。

デフォルト値: False

VALIDATE_EXTERNAL_PART_TABLEプロシージャ

このプロシージャは、外部パーティション表のソース・ファイルを検証し、ログ情報を生成し、外部表に指定されたフォーマット・オプションと一致しない行をAutonomous Databasebadfile表に格納します。オーバーロード・フォームでは、operation_idパラメータを使用できます。

構文

DBMS_CLOUD.VALIDATE_EXTERNAL_PART_TABLE (
       table_name                 IN VARCHAR2,
       partition_name             IN CLOB DEFAULT,
       subpartition_name          IN CLOB DEFAULT,
       schema_name                IN VARCHAR2 DEFAULT,
       rowcount                   IN NUMBER DEFAULT,
       partition_key_validation   IN BOOLEAN DEFAULT,
       stop_on_error              IN BOOLEAN DEFAULT);


DBMS_CLOUD.VALIDATE_EXTERNAL_PART_TABLE (
       table_name                 IN VARCHAR2,
       operation_id               OUT NUMBER,
       partition_name             IN CLOB DEFAULT,
       subpartition_name          IN CLOB DEFAULT,
       schema_name                IN VARCHAR2 DEFAULT,
       rowcount                   IN NUMBER DEFAULT,
       partition_key_validation   IN BOOLEAN DEFAULT,
       stop_on_error              IN BOOLEAN DEFAULT);

Parameters

パラメータ 説明

table_name

外部表の名前。

operation_id

このパラメータを使用して、USER_LOAD_OPERATIONSビューで、ロード操作の進行状況および最終ステータスを対応するIDとして追跡します。

partition_name

定義すると、特定のパーティションのみが検証されます。指定しない場合は、rowcountに達するまで、すべてのパーティションを順次読み取ります。

subpartition_name

定義すると、特定のサブパーティションのみが検証されます。指定しない場合は、rowcountに達するまで、すべての外部パーティションまたはサブパーティションから順次読み取ります。

schema_name

外部表が存在するスキーマの名前。デフォルト値はNULLで、外部表がプロシージャを実行しているユーザーと同じスキーマ内に存在することを意味します。

rowcount

スキャンされる行数。デフォルト値はNULLで、ソース・ファイル内のすべての行がスキャンされることを意味します。

partition_key_validation

内部使用のみ。このパラメータは使用しないでください。

stop_on_error

行が拒否されたときに検証を停止するかどうかを決定します。デフォルト値はTRUEで、最初に拒否された行で検証を停止することを意味します。値をFALSEに設定すると、最初に拒否された行で検証を停止せず、rowcountパラメータに指定された値までのすべての行を検証することを指定します。

VALIDATE_EXTERNAL_TABLEプロシージャ

このプロシージャは、外部表のソース・ファイルを検証し、ログ情報を生成して、外部表に指定されたフォーマット・オプションと一致しない行をAutonomous Databasebadfile表に格納します。オーバーロード・フォームでは、operation_idパラメータを使用できます。

構文

DBMS_CLOUD.VALIDATE_EXTERNAL_TABLE (
	table_name      IN VARCHAR2,
	schema_name     IN VARCHAR2 DEFAULT,		
	rowcount        IN NUMBER DEFAULT,
	stop_on_error   IN BOOLEAN DEFAULT);


DBMS_CLOUD.VALIDATE_EXTERNAL_TABLE(
	table_name      IN VARCHAR2,
	operation_id    OUT NOCOPY NUMBER,
	schema_name     IN VARCHAR2 DEFAULT NULL,		
	rowcount        IN NUMBER DEFAULT 0,
	stop_on_error   IN BOOLEAN DEFAULT TRUE);

Parameters

パラメータ 説明

table_name

外部表の名前。

operation_id

このパラメータを使用して、USER_LOAD_OPERATIONSビューで、ロード操作の進行状況および最終ステータスを対応するIDとして追跡します。

schema_name

外部表が存在するスキーマの名前。デフォルト値はNULLで、外部表がプロシージャを実行しているユーザーと同じスキーマ内に存在することを意味します。

rowcount

スキャンされる行数。デフォルト値はNULLで、ソース・ファイル内のすべての行がスキャンされることを意味します。

stop_on_error

行が拒否されたときに検証を停止するかどうかを決定します。デフォルト値はTRUEで、最初に拒否された行で検証を停止することを意味します。値をFALSEに設定すると、最初に拒否された行で検証を停止せず、rowcountパラメータに指定された値までのすべての行を検証することを指定します。

外部表がAvro、ORCまたはParquetファイルを参照している場合、検証は最初に拒否された行を停止します。

外部表でformatパラメータのtypeが値avroorcまたはparquetに設定されている場合、stop_on_errorパラメータの値は事実上常にTRUEです。そのため、Avro、ORCまたはParquetファイルを参照している外部表では、badfile表は常に空になります。

使用上のノート

  • DBMS_CLOUD.VALIDATE_EXTERNAL_TABLEは、パーティション外部表とハイブリッド・パーティション表の両方で機能します。これは、rowcountに達するか、stop_on_errorが適用されるまで、場合によってはすべての外部パーティションからデータを読み取ります。読み取るパーティション(またはパーティションの一部)の順序は制御できません。

VALIDATE_HYBRID_PART_TABLEプロシージャ

このプロシージャは、ハイブリッド・パーティション表のソース・ファイルを検証し、ログ情報を生成し、ハイブリッド表に指定されたフォーマット・オプションと一致しない行をAutonomous Databasebadfile表に格納します。オーバーロード・フォームでは、operation_idパラメータを使用できます。

構文

DBMS_CLOUD.VALIDATE_HYBRID_PART_TABLE (
       table_name                 IN VARCHAR2,
       partition_name             IN CLOB DEFAULT,
       subpartition_name          IN CLOB DEFAULT,
       schema_name                IN VARCHAR2 DEFAULT,
       rowcount                   IN NUMBER DEFAULT,
       partition_key_validation   IN BOOLEAN DEFAULT,
       stop_on_error              IN BOOLEAN DEFAULT);


DBMS_CLOUD.VALIDATE_HYBRID_PART_TABLE (
       table_name                 IN VARCHAR2,
       operation_id               OUT NUMBER,
       partition_name             IN CLOB DEFAULT,
       subpartition_name          IN CLOB DEFAULT,
       schema_name                IN VARCHAR2 DEFAULT,
       rowcount                   IN NUMBER DEFAULT,
       partition_key_validation   IN BOOLEAN DEFAULT,
       stop_on_error              IN BOOLEAN DEFAULT);

Parameters

パラメータ 説明

table_name

外部表の名前。

operation_id

このパラメータを使用して、USER_LOAD_OPERATIONSビューで、ロード操作の進行状況および最終ステータスを対応するIDとして追跡します。

partition_name

定義すると、特定のパーティションのみが検証されます。指定されていない場合は、rowcountに達するまで、すべての外部パーティションから順次読み取ります。

subpartition_name

定義すると、特定のサブパーティションのみが検証されます。指定しない場合は、rowcountに達するまで、すべての外部パーティションまたはサブパーティションから順次読み取ります。

schema_name

外部表が存在するスキーマの名前。デフォルト値はNULLで、外部表がプロシージャを実行しているユーザーと同じスキーマ内に存在することを意味します。

rowcount

スキャンされる行数。デフォルト値はNULLで、ソース・ファイル内のすべての行がスキャンされることを意味します。

partition_key_validation

内部使用のみ。このパラメータは使用しないでください。

stop_on_error

行が拒否されたときに検証を停止するかどうかを決定します。デフォルト値はTRUEで、最初に拒否された行で検証を停止することを意味します。値をFALSEに設定すると、最初に拒否された行で検証を停止せず、rowcountパラメータに指定された値までのすべての行を検証することを指定します。