共有の消費

JSONプロファイルについて

Delta Sharing Profilesは、共有プロバイダに接続し、Delta Sharing Serverにアクセスするのに役立ちます。プロファイル情報は、JSON形式のクライアント資格証明を含むZipファイルに格納されます。共有データにアクセスするには、認可されたJSONプロファイルを使用して共有オブジェクトを登録する必要があります。その後、JSONプロファイルを使用してDelta Sharing Serverで認証し、使用可能なデータ共有にアクセスできます。

JSONプロファイルのダウンロード

共有ツールが共有オブジェクトを作成すると、受信者はDelt@共有プロファイルをダウンロードするためのリンクを含む電子メール通知を受信します。データベース・アクション・コンソールからJSONプロファイルをダウンロードすることもできます:

1. 「共有の指定」ページで、受信者の横にある3つのドットをクリックし、「プロファイル・アクティブ化リンクをクリップボードにコピー」を選択します。

2. このリンクをWebブラウザで開き、デルタ プロファイル ダウンロード ページにアクセスします。

3. 「プロファイル情報の取得」をクリックして、Delta Sharing JSONプロファイルを含むZipファイルをダウンロードします。

JSONプロファイル・タイプ

この図は、JSONプロファイルを示し、DatabricksのbearerTokenおよびOIDCを使用してデルタ共有を使用する方法を示しています。

図版adp-databricks-delta-share-oidc.epsの説明

デルタ共有では、次のプロファイルがサポートされています。

• BearerTokenを使用したプロファイル・バージョン1

  このJSONファイルには、トークンをリフレッシュできるように、tokenEndpoint、clientIDおよびclientSecretを含めることができます。

• Databricks共有でのOIDC (PL/SQLのみ)を使用したプロファイル・バージョン2

  このJSONファイルには、OpenID Connect (OIDC)およびOAuthクライアント資格証明(clientId、clientSecret、tokenEndpointなど)が含まれています。Databricks OIDCプロファイルでは、shareCredentialsVersion 2およびtype oauth_client_credentialsが使用されますが、bearerTokenはサポートされていません。Autonomous Databaseでは、tokenEndpointを使用して、有効性が短いアクセス・トークンを取得し、自動的にリフレッシュします。

  プロファイル・バージョン2では、配布する存続期間が長いベアラー・トークンがなく、シークレットのローテーションが簡単で、自動化が強化されるため、セキュリティが向上します。

消費共有でデルタ共有プロバイダをサブスクライブする場合、JSONファイル・バージョン1またはバージョン2を使用するか、「共有プロバイダJSON」フィールドにZipファイルを直接アップロードできます。

{
        "shareCredentialsVersion": 1, 
        "endpoint": "https://myhost.us.example.com/ords/prov/_delta_sharing/", 
        "tokenEndpoint": "http://myhost.us.example.com:1234/ords/pdbdba/oauth/token", 
        "bearerToken": "-xxxxxxxxxxxxxxxxxxxxx", 
        "expirationTime": "20XX-01-13T07:53:11.073Z", 
        "clientID": "xxxxxxxxxxxxxxxxxxxxxx..", 
        "clientSecret": "xxxxxxxxxxxxxxxxxxxx.."
}

{
        "shareCredentialsVersion": 2, 
        "endpoint": "https://myhost.us.example.com/ords/prov/_delta_sharing/", 
        "tokenEndpoint": "http://myhost.us.example.com:1234/ords/pdbdba/oauth/token", 
        "type": "oauth_client_credentials",
        "clientId": "xxxxxxxxxxxxxxxxxxxxxx..", 
        "clientSecret": "xxxxxxxxxxxxxxxxxxxx..",
        "tokenScope": "xxxxxxxxxx"
}

両方のプロファイルのクライアントIDの場合の違いに注意してください。プロファイル1にはclientIDがあり、プロファイル2にはclientIdがあります。

セキュリティの強化

共有受信者として、共有プロバイダのマシンに対するアクセス制御リスト(ACL)を設定する必要があります。これには、ADMINユーザーまたは別の権限を持つユーザーとしてAPPEND_HOST_ACEプロシージャを使用します。これにより、インターネット経由で共有にアクセスできます。

たとえば、データベース・ユーザー、A_SHARE_USERに指定したホスト(共有プロバイダ)のエンドポイントへのアクセスを許可する場合に、SQLワークシート・エディタで管理者として実行するPL/SQLプロシージャのサンプルを次に示します。前提条件として、前述の例に示すように、デルタ共有JSONプロファイルのエンドポイント・プロパティからホスト名を抽出します。例のホスト名はmyhost.us.example.comです。

BEGIN 
        dbms_network_acl_admin.append_host_ace(    
        host =>'myhost.us.example.com', 
        lower_port=>443,    
        upper_port=>443,
        ace => xs$ace_type(      
        privilege_list => xs$name_list('http', 'http_proxy'),      
        principal_name =>'A_SHARE_USER',
        principal_type => xs_acl.ptype_db)); 
        COMMIT;
        END;        
/

パラメータとその説明を次に示します。

• host- ホストの名前またはIPアドレスを指定します、ホストまたはドメイン名は大/小文字が区別されません。
• lower port- オプションのTCPポート範囲の下側のポートを指定します。
• upper port- オプションのTCPポート範囲の上側のポートを指定します。
• ace– アクセス制御エントリ。
• privilege list- 付与または拒否するネットワーク権限のリストを指定します。
• principal_name- 権限が付与または拒否されるプリンシパルのことです(データベース・ユーザーまたはロール)。大文字と小文字が区別されます。
• principal_type- 使用するプリンシパルのタイプを指定します。

DBMS_NETWORK_ACL_ADMINパッケージ・サブプログラムの詳細は、PL/SQLパッケージ・プロシージャおよびタイプ・リファレンスのドキュメントを参照してください。

PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

JSONプロファイルのアップロードによる共有プロバイダ・サブスクリプションの作成

このプロセスでは、受信者へのアクセスを有効にするために、プロバイダの構成および資格証明のJSONプロファイルをロードします。

1. 「共有の消費」ページを開き、「+共有プロバイダへのサブスクライブ」をクリックして、ドロップダウンから「デルタ共有プロバイダへのサブスクライブ」を選択します。これにより、「共有プロバイダのサブスクライブ」ウィンドウが開きます。
   図subscribe-share-provider-version-providersettings.pngの説明
2. 「プロバイダ設定」で次を指定します。

   • Share Source: 「Delta Share Provider JSON」を選択します。

   • 共有プロバイダJSON: 次のオプションを使用してJSONプロファイルを共有できます-

     ファイルから: このオプションを選択し、「デルタ共有プロファイルJSON」をクリックして、システム上のJSONプロファイルを参照およびアップロードします。または、JSONプロファイルを含むZipファイルを「プロバイダJSONの共有」フィールドに直接アップロードすることもできます。

     JSON: JSONファイルの内容を指定された領域に貼り付けるには、このオプションを選択します。開始中カッコと終了中カッコを含むコンテンツ全体を必ずコピーしてください。

   • 「共有プロバイダの詳細」で、「プロバイダ名」を入力し、オプションで「説明」を追加します。

   「次」をクリックして、「共有の追加」タブに進みます。
3. ダイアログの「共有の追加」タブで、使用可能な共有のリストを表示します。「使用可能な共有」から消費するシェアをクリックし、使用可能なオプションのいずれかを選択します。
   図subscribe-share-provider-version-addshares.pngの説明
   • >: このオプションを使用すると、「使用可能な共有」を「選択した共有」に移動できます。
   • <: 選択したシェアを「選択したシェア」から削除するには、このオプションを選択します。
   • >>: このオプションを使用すると、すべてのシェアを「選択された共有」に移動します。
   • <<: 選択したシェアを「選択したシェア」からすべて削除するには、このオプションを選択します。

4. 「サブスクライブ」をクリックして、共有を追加します。プロバイダが正常に作成されると、確認プロンプトが表示されます。プロバイダが正常に作成されると、「データ・ロード」ページの「クラウド・オブジェクトのリンク」画面が表示されます。

5. 「クラウド・ストレージの場所」フィールドにプロバイダの名前を表示できます。共有は、共有に追加したファイルとともにソース・ファイルの場所に表示されます。
   図link-cloud-object.pngの説明

   「共有」フォルダ・カートを展開し、共有するファイルをソースからデータ・リンク・カートにドラッグ・アンド・ドロップします。

   データ・リンク・カートで「開始」を選択して、データ・リンク・ジョブを実行します。

6. データベース・アクションから作成された表を表示します。
   • ブレッドクラムの「データベース・アクション」をクリックして、データベース・アクションの起動パッドに戻ります。
   • 「SQL」タイルをクリックします。
   • 外部表を選択し、ワークシートにドラッグ・アンド・ドロップします。

     表のSQL Select文が表示されます。このSQL文を実行して、共有データを消費できます。

     
     図xt_sql.pngの説明

ORA-29913: error while processing ODCIEXTTABLEFETCH routine

Databricksプロバイダは、自律型AIデータベースがデルタ共有コンシューマである場合に、次のシナリオでデルタ表を共有できます。

• シナリオ1 - 表からの削除ベクトルの削除

• シナリオ2 - ビューを作成してビューを共有する

• シナリオ3 - 将来の表のワークスペース設定での削除ベクターの無効化

シナリオ1 - 表からの削除ベクトルの削除

特定の表でdeletionVectorsの使用を停止する準備ができている場合は、これを使用します。

1. これをDatabricksで実行します。

   ALTER TABLE table_name 
   DROP FEATURE deletionVectors

2. Delt@共有に表table_nameを追加し、Autonomous AI Databaseをコンシューマとして構成します。

このオプションは、保留中のすべての削除を適用し、表からdeletionVectors機能を削除します。表は、deletionVectorsのない通常のDelta表と同様に動作します。

シナリオ2 - ビューの作成およびビューの共有

これは、実表にdeletionVectorsを保持する場合に使用します。

1. これをDatabricksで実行します。

   CREATE VIEW view_name AS 
   SELECT * FROM table_name;

2. 表のかわりに、ビューview_nameをDelta共有に追加します。

   自律型AIデータベース・コンシューマは、次の問合せを実行できます:

   SELECT * 
   FROM "MY_SHARE"."MY_SCHEMA"."view_name";

このシナリオでは、Databricks実表は削除ベクトルを引き続き使用します。Databricksでは、ビューの実行時に削除ベクトルが解決されるため、Autonomous AI Databaseでは表示されません。自律型AIデータベースなど、Databricks以外の受信者の場合、Databricksはビューを実体化し、コンピュートおよびストレージのプロバイダに課金する場合があります。プロバイダは、データブリックでマテリアライズド・TTLを構成して、コストとデータのリフレッシュのバランス、新しいデータのTTLの短縮または低減、またはコスト効率の高いTTLの長期化を制御できます。

シナリオ3 - 将来の表のワークスペース設定での削除ベクターの無効化

これを使用して、新しい表がデフォルトで削除ベクトルを使用しないようにします。

1. ワークスペース設定または管理コンソールをDatabricks管理ユーザーとして開き、「詳細」に移動します。

2. 「削除ベクタの自動有効化」を見つけて、「無効」に設定します。

3. 変更を保存して、実行中のコンピュートを再起動します。

ALTER TABLE table_name 
SET TBLPROPERTIES ('delta.enableDeletionVectors' = FALSE);

このシナリオでは、この変更後に作成されたすべての新しい表で、デフォルトで削除ベクトルが有効になっていません。ただし、すでに削除ベクトルを使用している既存の表には、前述したシナリオが必要です。

データブリックで削除ベクトルが有効になっているかどうかを確認する

Databricksの特定の表で削除ベクトルが有効になっているかどうかを確認するには、次のコマンドを実行します。

SHOW TBLPROPERTIES table_name ('delta.enableDeletionVectors');