Google Cloud StorageからAutonomous Databaseへのデータのロード

この例では、Google Cloud Storageから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コマンドよりも追加の利点があります。ソースの分析と表定義の作成に役立つだけでなく、検証チェックも実行します。

ユーザー・アカウント認証のGoogle Cloud Platform (GCP)アクセス資格証明と、Google Cloud Storageバケット内のオブジェクトにアクセスするためのオブジェクトURLが必要です。

Google Cloud Storageバケットからデータをロードするには:

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

トピック

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

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

Google Cloud Storageからのデータのロードの準備

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

前提条件

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

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

Google側で、Google Cloud Platform (GCP)アカウントにログインし、次の操作を行います:

ユーザーのアクセス・キーを作成します。
詳細は、「HMACキー」を参照してください。
Google Cloud Storageバケットに格納されているデータファイルのオブジェクトURLを取得します。
詳細は、「リクエスト・エンドポイント」を参照してください。

親トピック: Google Cloud StorageからAutonomous Databaseへのデータのロード

Google Cloud Storageからデータをロードするステップ

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

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

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

Googleサービス・アカウントを有効にする場合、Google Cloud Platform (GCP)にアクセスするための資格証明を作成する必要はありません。詳細については、「Googleサービス・アカウントを使用したGoogle Cloud Platformリソースへのアクセス」を参照してください。
オプションで、この例に示すように、Google Cloud Storageバケットへのアクセスをテストできます。
```
SELECT * FROM DBMS_CLOUD.LIST_OBJECTS('GOOGLE_CRED_NAME', 'https://bucketname.storage.googleapis.com/');
```
データをロードする表をデータベースに作成します。
```
CREATE TABLE mygoogletable (id NUMBER, name VARCHAR2(64));
```
Google Cloud StorageバケットからAutonomous Databaseにデータをインポートします。
表名とGCP資格証明名を指定し、その後にGoogle Cloud StorageオブジェクトURLを指定します。
```
BEGIN
      DBMS_CLOUD.COPY_DATA(
          table_name => 'mygoogletable',
          credential_name => 'GOOGLE_CRED_NAME',
          file_uri_list => 'https://bucketname.storage.googleapis.com/gcp-data.txt',
          format => json_object('delimiter' value ',')
      );
END;
/
```
パラメータの詳細は、「COPY_DATAプロシージャ」を参照してください。

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

SELECT * FROM mygoogletable;

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

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

親トピック: Google Cloud StorageからAutonomous Databaseへのデータのロード