データをCSVとしてクラウド・オブジェクト・ストレージにエクスポート
問合せを指定して、Autonomous AI DatabaseからCloud Object StorageにCSVデータとして表データをエクスポートするステップを示します。
このエクスポート方法では、Autonomous AI Databaseでサポートされているすべてのクラウド・オブジェクト・ストアがサポートされ、Oracle Cloud Infrastructureリソース・プリンシパルを使用して、Oracle Cloud Infrastructureオブジェクト・ストア、Amazonリソース名(ARN)にアクセスできますAWS Simple Storage Service (S3)、Azure BLOBストレージまたはAzure Data Lake StorageにアクセスするためのAzureサービス・プリンシパル、またはGoogle Cloud Platform (GCP)リソースにアクセスするためのGoogleサービス・アカウントにアクセスします。
-
Autonomous AI Databaseインスタンスに接続します。
詳細は、Autonomous AI Databaseへの接続を参照してください。
-
DBMS_CLOUD.CREATE_CREDENTIALを使用してクラウド・オブジェクト・ストレージ資格証明を格納してください。たとえば:
BEGIN DBMS_CLOUD.CREATE_CREDENTIAL( credential_name => 'DEF_CRED_NAME', username => 'user1@example.com', password => 'password' ); END; /usernameおよびpasswordに指定する値は、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なりますリソース・プリンシパル資格証明を有効にする場合、Oracle Cloud Infrastructureオブジェクト・ストアにアクセスするための資格証明の作成は必要ありません。詳細は、リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセスを参照してください。
-
DBMS_CLOUD.EXPORT_DATAを実行し、formatパラメータtypeを値csvとともに指定して、結果をCSVファイルとしてクラウド・オブジェクト・ストレージにエクスポートします。CSV出力ファイルを生成するには、
file_uri_listパラメータに次の2つのオプションがあります。-
file_uri_list値を、クラウド・オブジェクト・ストレージ上の既存のバケットのURLに設定します。 -
file_uri_list値をクラウド・オブジェクト・ストレージ上の既存のバケットのURLに設定し、エクスポートされたCSVファイルのファイル名を生成するときに使用するファイル名接頭辞を含めます。
file_uri_listにファイル名接頭辞を含めない場合、DBMS_CLOUD.EXPORT_DATAはファイル名接頭辞を指定します。詳細は、テキスト出力(CSV、JSON、ParquetまたはXML)のファイル・ネーミングを参照してください。たとえば、
file_uri_listで指定されたファイル名接頭辞を持つDBMS_CLOUD.EXPORT_DATAを次に示します。BEGIN DBMS_CLOUD.EXPORT_DATA( credential_name => 'DEF_CRED_NAME', file_uri_list => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export', query => 'SELECT * FROM DEPT', format => JSON_OBJECT('type' value 'csv', 'delimiter' value '|', 'compression' value 'gzip')); END; /この例では、
namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。パラメータの詳細は、「EXPORT_DATAプロシージャ」を参照してください。
DBMS_CLOUD.EXPORT_DATAで使用できるformatパラメータの詳細は、「EXPORT_DATAのDBMS_CLOUDパッケージのフォーマット・オプション」を参照してください。 -
DBMS_CLOUD.EXPORT_DATAを使用したエクスポートに関するノート:
-
指定する
queryパラメータには、必要に応じて、結合や副問合せを含む問合せなどの拡張問合せを指定できます。 -
出力ファイルを圧縮するには、
formatパラメータをcompressionオプションとともに指定します。 -
エクスポート時にデータを暗号化するには、
formatパラメータをencryptionオプションとともに指定します。詳細は、オブジェクト・ストレージへのエクスポート中のデータの暗号化を参照してください。 -
エクスポートするファイルが必要なくなった場合は、プロシージャ
DBMS_CLOUD.DELETE_OBJECTを使用するか、ネイティブのCloud Object Storageコマンドを使用してファイルを削除します。