AWS S3からAutonomous Databaseにデータをロード

この例では、Amazon S3オブジェクト・ストレージからAutonomous Databaseにデータをロードする方法を示します。

Autonomous Databaseへのデータ・ロードを実行する様々なオプションがあります。次に例を示します:

「UIの使用」オプション: Data Studioロード・ツールのユーザー・インタフェースを使用して、クラウド・ストアのロケーションの資格証明を作成し、データを含むファイルを選択して、データ・ロード・ジョブを実行できます。

「クラウド・ストレージからのデータのロード」を参照してください
Restデータ・サービスAPIの使用: Data Studioロード・ツールAPIを使用して、クラウド・ストアのロケーションへのリンクを作成し、データ・ロード・ジョブを実行できます。

「PL/SQLでのData Studioデータ・ロードAPIの使用」を参照してください
この例では、SQLコマンドを使用します。

これらのメソッドはすべて、データのロードに同じPL/SQLパッケージDBMS_CLOUDを使用します。ただし、Data StudioにはSQLコマンドよりも追加の利点があります。ソースの分析と表定義の作成に役立つだけでなく、検証チェックも実行します。

ユーザー・アカウント認証用のAWSアクセス資格証明と、Amazon S3バケット内のオブジェクトにアクセスするためのオブジェクトURLが必要です。

Amazon S3バケットからデータをロードするには:

Autonomous DatabaseにAWSユーザー・アカウントの資格証明を作成します。
Amazon S3バケットからデータベースにデータをコピーします。

トピック

AWS S3からのデータのロードの準備
前提条件を確認し、Amazon S3からデータをロードする準備をします。
AWS S3からデータをロードするステップ
次のステップを実行して、Amazon S3からAutonomous Databaseにデータをロードします。

親トピック: Autonomous Databaseへのデータのロードの例

AWS S3からのデータのロードの準備

前提条件を確認し、Amazon S3からデータをロードする準備をします。

前提条件

データ・ファイル(たとえば、data.txt)は、インポートできるAmazon S3バケットに存在します。この例のサンプル・ファイルの内容は次のとおりです:

1,Direct Sales
2,Tele Sales
3,Catalog
4,Internet
5,Partners

AWS側で、AWSアカウントにログインし、次の手順を実行します:

Amazon S3バケットのAWS IAMユーザーにアクセス権限を付与します。
詳細は、「ユーザー・ポリシーを使用したバケットへのアクセスの制御」を参照してください。
ユーザーのアクセス・キーを作成します。
詳細は、「IAMユーザーのアクセス・キーの管理」を参照してください。
Amazon S3バケットに格納されているデータ・ファイルのオブジェクトURLを取得します。
詳細は、「Amazon S3バケットへのアクセスおよびリスト」を参照してください。

親トピック: AWS S3からAutonomous Databaseにデータをロード

AWS S3からデータをロードするステップ

次のステップを実行して、Amazon S3からAutonomous Databaseにデータをロードします。

AWSアクセス資格証明をAutonomous Databaseに格納し、資格証明名を指定します。これにより、データベースはAWSユーザー・アカウントで認証し、S3バケット内のアイテムにアクセスできます。
```
SET DEFINE OFF
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'AWS_CRED_NAME',
    username => 'username',
    password => 'password'
  );
END;
/
```
ノート:
ここで、usernameはAWS AccessキーIDで、「パスワード」はユーザー・アクセス・キーです。

パラメータの詳細は、「CREATE_CREDENTIALプロシージャ」を参照してください。

Amazonリソース名(ARN)を有効にする場合、AWSリソースにアクセスするための資格証明の作成は必要ありません。詳細については、「Amazonリソース名(ARN)を使用したAWSリソースへのアクセス」を参照してください。
オプションで、この例に示すように、S3バケットへのアクセスをテストできます。
```
SELECT * FROM DBMS_CLOUD.LIST_OBJECTS('AWS_CRED_NAME', ' https://aws-bucket-01.s3.amazonaws.com/');
```
データをロードする表をデータベースに作成します。
```
CREATE TABLE mytable (id NUMBER, name VARCHAR2(64));
```
Amazon S3バケットからAutonomous Databaseにデータをインポートします。
表名およびAWS資格証明名に続けて、S3オブジェクトURLを指定します。
```
BEGIN
      DBMS_CLOUD.COPY_DATA(
          table_name => 'mytable',
          credential_name => 'AWS_CRED_NAME',
          file_uri_list => https://aws-bucket-01.s3.amazonaws.com/data.txt',
          format => json_object('delimiter' value ',')
      );
END;
/
```
パラメータの詳細は、「COPY_DATAプロシージャ」を参照してください。

Amazon S3からAutonomous Databaseにデータを正常にインポートしました。この文を実行して、表のデータを検証できます。

SELECT * FROM mytable;

ID  NAME
--  –-------------
 1  Direct Sales
 2  Tele Sales
 3  Catalog
 4  Internet
 5  Partners

データのロードの詳細は、「クラウドのファイルからのデータのロード」を参照してください。

親トピック: AWS S3からAutonomous Databaseにデータをロード