資格証明の作成と既存表へのデータのコピー
クラウドのファイルからデータをロードするには、最初にオブジェクト・ストレージ資格証明をAutonomous Databaseに保存してから、プロシージャDBMS_CLOUD.COPY_DATA
を使用してデータをロードします。
この例のソース・ファイルchannels.txt
には、次のデータが含まれています:
S,Direct Sales,Direct T,Tele Sales,Direct C,Catalog,Indirect I,Internet,Indirect P,Partners,Others
- プロシージャ
DBMS_CLOUD.CREATE_CREDENTIAL
を使用してオブジェクト・ストアの資格証明を保存します。たとえば:SET DEFINE OFF BEGIN
DBMS_CLOUD.CREATE_CREDENTIAL
( credential_name => 'DEF_CRED_NAME', username => 'adb_user@example.com', password => 'password' ); END; /この操作によって、資格証明が暗号化された形式でデータベースに格納されます。資格証明には任意の名前を使用できます。オブジェクト・ストアの資格証明を変更しないかぎり、このステップが必要なのは1回のみです。資格証明を格納した後は、すべてのデータ・ロードで同じ資格証明名を使用できます。
パラメータの詳細は、CREATE_CREDENTIALプロシージャを参照してください。
リソース・プリンシパル資格証明を有効にする場合、Oracle Cloud Infrastructure Object Storeにアクセスするための資格証明を作成する必要はありません。詳細は、リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセスを参照してください。
ノート
SQL*PlusやSQL Developerなどの一部のツールは、特殊文字としてアンパサンド文字(&
)を使用します。パスワードにアンパサンド文字が含まれる場合、例に示すように、これらのツールでSET DEFINE OFF
コマンドを使用して特殊文字を無効にし、資格証明を適切に作成します。 - プロシージャ
DBMS_CLOUD.COPY_DATA
を使用して、既存の表にデータをロードします。たとえば:CREATE TABLE CHANNELS (channel_id CHAR(1), channel_desc VARCHAR2(20), channel_class VARCHAR2(20) ); / 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; /パラメータは次のとおりです:
-
table_name
: ターゲット表の名前です。 -
credential_name
: 前のステップで作成された資格証明の名前です。credential_name
パラメータは、スペースやハイフンを使用できないOracleオブジェクトの命名規則に準拠している必要があります。 -
file_uri_list
: ロードするソース・ファイルのカンマ区切りリストです。 -
format
: ソース・ファイルのフォーマット(ファイル・タイプがテキスト、ORC、Parquet、Avroのいずれかなど)を記述するために指定できるオプションを定義します。ソース・ファイルのデータが暗号化されている場合は、
encryption
オプションを指定してformat
パラメータを指定して、データを復号化します。データの復号化の詳細は、オブジェクト・ストレージからのインポート中のデータの復号化を参照してください。
この例では、
namespace-string
はOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketname
はバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。ノート
Autonomous Databaseは、圧縮データ形式を含む様々なソース・ファイル形式をサポートしています。サポートされている圧縮タイプを確認するには、DBMS_CLOUDパッケージ・フォーマット・オプションおよびDBMS_CLOUD
compression
フォーマット・オプションを参照してください。パラメータの詳細は、COPY_DATAプロシージャおよびAvro、ORCまたはParquetファイル用COPY_DATAプロシージャを参照してください。
-
親トピック: クラウドのファイルからのデータのロード