Oracle Cloud Autonomous Data Warehouseへのアクセス

Oracle NoSQL Database Analytics IntegratorからOracle Cloud Autonomous Data Warehouseにアクセスするステップ。

Autonomous Data Warehouseでのデータベースの作成

Oracle NoSQL Database Analytics IntegratorからOracle Cloud Autonomous Data Warehouseにアクセスするには、データベースを作成する必要があります。Oracle Cloud Autonomous Data Warehouseにデータベースを作成するには、Oracle Cloudコンソールに移動し、次を実行します:
  • ディスプレイの左側にあるメニューから「Oracle Database」を選択します。
  • Autonomous Data Warehouseを選択します。
    oci-orcldb.pngの説明が続きます
    図oci-orcldb.pngの説明

  • データベースを作成するコンパートメントを選択します。
  • 「Autonomous Databaseの作成」をクリックします。
  • Autonomous Databaseの基本情報を入力します。たとえば、
    • コンパートメント: 上で選択したコンパートメント名を入力します。
    • 表示名: コンソールに表示する名前(NoSqlToAdwDbなど)。
    • データベース名: データベースへの接続時に使用する名前。例:NoSqlToAdwDb (14文字を超えることはできません)。

    crtadb-dbname.pngの説明が続きます
    図crtadb-dbname.pngの説明

  • 「データ・ウェアハウス」ワークロード・タイプを選択します。
  • 「共有インフラストラクチャ」デプロイメント・タイプを選択します。
    crtadb-wltype.pngの説明が続きます
    図crtadb-wltype.pngの説明

  • データベースのデフォルトの構成を選択します。
    crtadb-param.pngの説明が続きます
    図crtadb-param.pngの説明

  • 「管理者資格証明の作成」でパスワードを設定します。
    crtadb-admin.pngの説明が続きます
    図crtadb-admin.pngの説明

  • 「アクセス・タイプ」で、すべての場所から「セキュア・アクセスを許可」を選択します。
  • 適切なライセンス・タイプを選択します。独自のライセンスがある場合は、「Bring Your Own License (BYOL)」を選択します。
  • 「Autonomous Databaseの作成」をクリックします。
    crtadb-network.pngの説明が続きます
    図crtadb-network.pngの説明

関連項目

セキュアなデータベース接続に必要な資格証明のインストール

Autonomous Data Warehouseで作成したデータベースへの接続は、セキュアである必要があります。Oracle NoSQL Database Analytics IntegratorがADWデータベースに安全に接続するために、ユーティリティはOracle Walletに含まれている資格証明を使用します。

Oracle Walletを取得するには、Oracle Cloudコンソールに移動し、次を実行します:
  • ディスプレイの左側にあるメニューから「Oracle Database」を選択します。
  • Autonomous Data Warehouseを選択します。
    oci-orcldb.pngの説明が続きます
    図oci-orcldb.pngの説明

  • データベースが存在する「コンパートメント」を選択します。
  • データベースの作成時に入力した表示名のリンクをクリックします。
    adb-listdb.pngの説明が続きます
    図adb-listdb.pngの説明

  • 「サービス・コンソール」をクリックします。
    adb-srvconsole.pngの説明が続きます
    図adb-srvconsole.pngの説明

  • ディスプレイの左側にある「Administration」リンクをクリックします。
  • 「クライアント資格証明のダウンロード(Wallet)」を選択し、データベースの作成時に設定された管理パスワードを入力します。
    adb-adminstration.pngの説明が続きます
    図adb-adminstration.pngの説明

  • 安全な場所にファイル(zip)を保存します。
生成されるzipファイルには、次の項目が含まれています:
  • データベースに接続するために必要なネットワーク構成ファイル(tnsnames.oraおよびsqlnet.ora)。
  • 自動オープンSSOウォレット・ファイルcwallet.SSO。
  • PKCS12ファイル(ewallet.p12)。Oracle Cloudコンソールを介してzipファイルをダウンロードしたときに指定したウォレット・パスワードで保護されます。
  • ウォレット・パスワードで保護されているJavaキーストアおよびトラスト・ファイル(keystore.jsおよびtruststore.jks;)。
  • ファイルojdbc.properties。JDBC経由でデータベースに接続するために必要なウォレット関連のJavaシステム・プロパティを指定します。
  • ウォレットの有効期限情報を含むREADMEファイル。

ウォレットzipファイルを取得したら、パスワードをノートにとり、データベースに接続する任意の環境にウォレットを格納します。また、Oracle NoSQL Database Analytics Integratorを使用するには、ウォレットzipファイルの抽出された内容が、ユーティリティを実行する環境にインストールされている必要があります。たとえば、Oracle Cloud Computeインスタンスからユーティリティを実行する場合は、そのインスタンスの任意のディレクトリにあるzipファイルの内容を抽出する必要があります。次に、そのディレクトリへのパスを、ユーティリティの構成ファイルのデータベース・セクションでパラメータdatabaseWalletの値として使用します。

リソース・プリンシパル資格証明の有効化またはADWデータベースでのユーザーのオブジェクト・ストレージAUTH_TOKENの格納/有効化

目的のNoSQL Cloud Service表からデータを取得し、そのデータをオブジェクト・ストレージのParquetファイルに書き込むと、Oracle NoSQL Database Analytics Integratorでは、Oracle PL/SQL DBMS_CLOUDパッケージのサブプログラムを使用してオブジェクト・ストレージからParquetファイルを取得します。次に、これらのファイルに含まれるデータを、Oracle Cloud Autonomous Data Warehouseで作成したデータベースの表にロードします。

Oracle NoSQL Database Analytics Integratorでこれを行う前に、ADWデータベースがこれらのParquetファイルにアクセスするためにオブジェクト・ストレージで認証する方法を提供する必要があります。ADWデータベースは、OCIリソース・プリンシパルまたはユーザーまたはシステム管理者が生成するユーザー固有のAUTH_TOKENのいずれかを使用して、オブジェクト・ストレージ・サービスで認証できます。使用する認証メカニズムは、Oracle Cloudコンソールから次のステップを実行します。
  • ディスプレイの左側にあるメニューから「Oracle Database」を選択します。
  • Autonomous Data Warehouseを選択します。
    oci-orcldb.pngの説明が続きます
    図oci-orcldb.pngの説明

  • データベースが存在する「コンパートメント」を選択します。
  • データベースの作成時に入力した表示名のリンクをクリックします。
    adb-listdb.pngの説明が続きます
    図adb-listdb.pngの説明

  • 「サービス・コンソール」をクリックします。
    adb-srvconsole.pngの説明が続きます
    図adb-srvconsole.pngの説明

  • ディスプレイの左側にあるメニューから「Development」を選択します。
    adb-development.pngの説明が続きます
    図adb-development.pngの説明

  • 「データベース・アクション」を選択し、次のようにデータベースにログインします。
    • ユーザー名: ADMIN
    • パスワード: <password-set-during-database-creation>

    dbactions-login.pngの説明が続きます
    図dbactions-login.pngの説明

  • 「SQL」項目を選択します。
    dbactions-sqlsheet.pngの説明が続きます
    図dbactions-sqlsheet.pngの説明

  • [ワークシート]*というラベルのウィンドウから、リソース・プリンシパルを使用してオブジェクト・ストレージでADWデータベースを認証する場合は、次の手順を実行します。
    EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();

    dbactions-resource-principal.pngの説明が続きます
    図dbactions-resource-principal.pngの説明

    または、システム管理者が提供したAUTH_TOKENまたは自分で生成した認証を実行する場合は、プロシージャを実行します。

    BEGIN
DBMS_CLOUD.CREATE_CREDENTIAL (
credential_name => 'NOSQLADWDB_OBJ_STORE_CREDENTIAL',
username => '<your-Oracle-Cloud-username>',
password => '<cut-and-paste-the-AUTH_TOKEN>'
);
END;

    dbactions-worksheet.pngの説明が続きます
    図dbactions-worksheet.pngの説明

DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPALプロシージャは、オブジェクト・ストレージなどのOCIリソースで認証する際に、ADWデータベースで使用するOCIリソース・プリンシパル(OCI$RESOURCE_PRINCIPALという名前)を有効にします。DBMS_CLOUD.CREATE_CREDENTIALプロシージャは、指定されたAUTH_TOKEN資格証明を暗号化し、それをadwc_userという名前のデータベース内の表に格納します。どのプロシージャを使用する場合でも、そのプロシージャは1回のみ実行する必要があります。その後、オブジェクト・ストレージからADWデータベースへのすべての転送に同じ資格証明名を指定できます。

ノート:

ADWデータベースがOCIリソース・プリンシパルを使用してオブジェクト・ストレージで認証する場合、資格証明の名前はOCI$RESOURCE_PRINCIPALです。または、AUTH_TOKENを使用してオブジェクト・ストレージで認証する場合、資格証明の名前は、DBMS_CLOUD.CREATE_CREDENTIALプロシージャのcredential_nameパラメータに指定した値です。ただし、前述の値(NOSQLADWDB_OBJ_STORE_CREDENTIAL)は単なる例です。お好きな名前をお選びください。したがって、構成ファイル内のdbmsCredentialNameパラメータには、値OCI$RESOURCE_PRINCIPAL、またはここでcredential_nameパラメータに指定した名前のいずれかを含める必要があります。これは、オブジェクト・ストレージを使用したADWデータベースの認証に使用する認証メカニズムによって異なります。