• オブジェクト・ストレージ資格証明をAutonomous Databaseに格納します
• データベース・リンクの作成、または既存のデータベース・リンクの使用
• データベース・リンクをカタログとしてマウントします。

• データベース・リンクの名前
• データにアクセスするために必要なクラウド資格証明

1. Icebergエンドポイント: Iceberg REST APIを使用してPolarisまたはUnityカタログを設定します。これには、カタログ・タイプ、URIおよびウェアハウスの場所の指定が含まれます。外部IcebergカタログのRESTエンドポイントが必要になります。これは、Icebergメタデータへのアクセスを提供するURLです。

   例: https://your-iceberg-catalog.com/api/v1/iceberg

2. トークン・エンドポイント: /v1/oauth/tokensエンドポイントは、Bearer Tokenを発行するためにIceberg RESTカタログによって提供されます。
3. クライアントIDおよびクライアント・シークレット: これらは、アプリケーションを識別するためにOAuthサーバーによって提供される資格証明です(この場合はUnityおよびPolarisカタログの統合)。これらの資格証明を使用してBearerトークンを生成します。
4. Bearerトークン: Iceberg RESTエンドポイントへのリクエストを認証するには、クライアント資格証明でOAuthを使用します。カタログ・ツールは、Bearer Tokenを受信するためにトークン・エンドポイントをコールします。
5. ネームスペース: ネームスペースは、データベース内のスキーマと同等です。この場所は、カタログ内のIcebergテーブルのリポジトリとして機能します。Icebergカタログは、表をネームスペースにグループ化し、他のネームスペース内にネストできます。Icebergの仕様は、任意のレベルの入れ子をサポートしています。

   たとえば、SALES表は、STORESネームスペース内で定義できます。このネームスペースは、RETAILネームスペースで定義され、CORPORATEネームスペース内で定義されます。このような表のIcebergの場所は CORPORATE.RETAIL.STORES.SALESです。

CREATE OR REPLACE CATALOG INTEGRATION tabular_catalog_int
  CATALOG_SOURCE = ICEBERG_REST
  TABLE_FORMAT = ICEBERG
  CATALOG_NAMESPACE = 'default'
  REST_CONFIG = (
    CATALOG_URI = 'https://api.tabular.io/ws'
    CATALOG_NAME = '<tabular_warehouse_name>'
  )
  REST_AUTHENTICATION = (
    TYPE = OAUTH
    OAUTH_TOKEN_URI = 'https://api.tabular.io/ws/v1/oauth/tokens'
    OAUTH_CLIENT_ID = '<oauth_client_id>'
    OAUTH_CLIENT_SECRET = '<oauth_secret>'
    OAUTH_ALLOWED_SCOPES = ('catalog')
  )
  ENABLED = TRUE;

1. 「カタログ」ページで、「カタログの管理」を選択します。+Addをクリックします
2. 「カタログの追加」ダイアログで、「カタログ・ソース」タブから「Icebergカタログ」を選択します。
   
   
   
   図add-catalog-iceberg.pngの説明
   
   

   「次へ」をクリックします

3. 「カタログの追加」ダイアログの「カタログ」ソース・タブで、次のフィールド値を指定します。

   • カタログ名: Icebergカタログをマウントするカタログの名前を入力します。

     たとえば、Polarisです。

   • Icebergカタログ・タイプ: ドロップダウン・フィールドから「Polaris」を選択します。

   • Icebergカタログ・エンドポイント: Polarisカタログ・アカウントURLを指定します。SnowflakeのPolarisカタログのエンドポイントは、通常、https://<account_locator>.snowflakecomputing.com/polaris/api/catalogの形式です。アカウント識別子フォーマットの詳細は、Snowflakeのドキュメントを参照してください。
   • Icebergカタログ資格証明: ドロップダウン・リストの使用可能な資格証明のリストから資格証明を選択します。資格証明がない場合は作成できます。「資格証明の作成」を選択します。「資格証明の作成」ダイアログで、次のフィールド値を指定します。
     • 資格証明名: 資格証明の名前を入力します。たとえば、POLARIS_CREDです。
       「新規Bearerトークンの取得」で、

       • アクセス・トークン・エンドポイント: Iceberg REST仕様エンドポイントを入力します。これにより、/v1/oauth/tokensとして定義されたOAuth2を使用してアクセス・トークンが生成されます。

         このエンドポイントは、クライアント資格証明(クライアントIDおよびシークレット)をアクセス・トークンと交換することによって、認証を容易にするように設計されています。

         ノート
         
         /v1/oauth/tokensエンドポイントは、Icebergバージョン1.6.0では非推奨であり、バージョン2.0では削除されます。かわりに、外部のOAuth2プロバイダを使用することをお薦めします。詳細は、OAuth認証を参照してください。
       • 付与タイプ: 「クライアント資格証明」を選択します。
       • クライアントID: クライアントIDを指定します。
       • クライアント・シークレット: クライアント・シークレットを指定します。
       • スコープ: PRINCIPAL_ROLE:ALL。

         「トークンの取得」をクリックします。

         「Bearer token」フィールドに値が移入されます。

       「資格証明の作成」をクリックします。

       POLARIS_CREDは、Icebergカタログ資格証明として表示されます。

       
       
       
       図create-credential-polaris.pngの説明
       
       
       ノート
       
       

       資格証明は、バックエンドのプロシージャDBMS_CLOUD.CREATE_CREDENTIALを使用して格納されます。

       前述の例では、プロシージャは次のようになります。

       BEGIN
         dbms_cloud.create_credential( 
           credential_name  =>  'POLARIS_CRED',
           username         =>  'BEARER_TOKEN',
           password         =>  '<BEARER_TOKEN_VALUE This is generated using token endpoint, client id, client secret>'
         );
       END;

     
     
     
     図add-polaris-catalog-source.pngの説明
     
     

     この資格証明により、Oracle Autonomous DatabaseはIceberg表にアクセスできます。

   • バケット資格証明: この資格証明には、Iceberg表をParquet形式で格納するためのクラウド・ストレージ・ボリュームが格納されます。このフィールドは、Polarisカタログには必須です。

     「次」をクリックして、「Icebergカタログ」タブに進みます。

4. 「Iceberg catalog」タブで、次のフィールド値を指定できます:

   • Icebergカタログ・ネームスペース: このフィールドには、表の階層編成が表示されます。Icebergカタログ・エンドポイントは、ルート・ネームスペースで構成されます。カタログをマウントするネームスペースを選択します。
   • ネームスペース・セパレータ・スタイル: 「ポラリス・スタイル」を選択します。これはデフォルト値です。カタログの構成方法に基づいて任意の値を選択します。
     ノート
     
     デフォルト値は保持することをお薦めします。
   • バケット・リージョン: バケット・リージョンを入力します。例: us-west-2

     Icebergカタログ・エンドポイントは、S3などのクラウド・ストレージに格納されているIceberg表を管理するためのインタフェースとして機能します。バケット・リージョンは、S3バケットがホストされている地理的な場所を参照します。

     これはPolarisカタログの必須フィールドです。

     
     
     
     図namespace-polaris.pngの説明
     
     

   「追加」をクリックします。

   Icebergカタログ上に新しいカタログを正常にマウントした後、「カタログの管理」ページでPolarisカタログを表示できます。このページからカタログを無効化および削除できます。

   
   
   
   図manage-polaris-catalogs.pngの説明
   
   

1. 「カタログ」ツールで、「カタログの選択...」をクリックします。
2. 「カタログおよびスキーマ」ウィザードで「POLARIS _CATALOG」フィルタをクリックして、POLARIS_CATALOGカタログを表示します。
3. 「適用」をクリックして、「カタログ」ページに結果を表示します。
   
   
   
   図catalogs-schemas-polaris-catalog.pngの説明
   
   

1. 「カタログ」ページで、「カタログの管理」を選択します。+Addをクリックします
2. 「カタログの追加」ダイアログで、「Icebergカタログ」を選択します。
   
   
   
   図add-catalog-iceberg.pngの説明
   
   
3. 「次へ」をクリックします
4. 「カタログの追加」ダイアログの「カタログ」ソース・タブで、次のフィールド値を指定します。
   • カタログ名: Icebergカタログをマウントするカタログの名前を入力します。

     たとえば、Unityです。

   • Icebergカタログ・タイプ: ドロップダウン・フィールドから「Unity」を選択します。
   • Icebergカタログ・エンドポイント:

     Unity Catalogの場合、通常はDatabricks REST APIを使用します。Unity Catalogを介してIceberg表にアクセスするためのエンドポイントは通常、https://<databricks-instance-url>/api/2.1/unity-catalog/icebergの形式です。

     ノート
     
     詳細は、https://docs.databricks.com/aws/en/external-access/icebergを参照してください。
   • Icebergカタログ資格証明: ドロップダウン・リストの使用可能な資格証明のリストから資格証明を選択します。資格証明がない場合は作成できます。「資格証明の作成」を選択します。
     「資格証明の作成」ダイアログで、次の値を指定します。

     • 資格証明名: 資格証明の名前を入力します。たとえば、UNITY_CREDです。
     • Bearerトークン: Bearerトークン値を貼り付けます。

       「資格証明の作成」を選択します。

       UNITY_CREDは、Icebergカタログ資格証明として表示されます。

     
     
     
     図add-unity-catalog.pngの説明
     
     

     「次」をクリックして、「Icebergカタログ」タブに進みます。

     「Iceberg catalog」タブで、次のフィールド値を指定できます:

   • Icebergカタログ・ネームスペース: アクセスする必要があるスキーマのいずれかを選択します。
   • ネームスペース・セパレータ・スタイル: ネームスペース・セパレータ・スタイルは、通常、カタログ内でネームスペースを構造化および分離する方法を表します。デフォルトでは、「データブリック・スタイル」が選択されています。
   • バケット・リージョン: このフィールドは必須ではありません。
     
     
     
     図iceberg-unity-catalog.pngの説明
     
     

     「追加」をクリックします。

     
     
     
     図manage-unity-catalogs.pngの説明
     
     

   Icebergカタログ上に新しいカタログを正常にマウントした後、「カタログの管理」ページでUnityカタログを表示できます。このページからカタログを無効化および削除できます。

1. 「カタログ」ツールで、「カタログの選択...」をクリックします。
2. 「カタログおよびスキーマ」ウィザードで「UNITY _CATALOG」フィルタをクリックして、UNITY_CATALOGカタログを表示します。
   
   
   
   図catalogs-schemas-unity-catalog.pngの説明
   
   
3. 「適用」をクリックして、「カタログ」ページに結果を表示します。
   
   
   
   図manage-catalogs-unity.pngの説明