データの共有

データ共有

Oracle AI Data Platformでのデータ共有により、データの重複なしに、組織内および組織内での安全で効率的なリアルタイムのデータ共有が可能になります。

AI Data Platformでは、Delta Sharingプロトコルを使用してデータを安全に共有します。データを共有するには、次のステップを完了する必要があります。

シェアを作成します。
共有するアセットを追加します。アセットには、スキーマまたは表を指定できます。
受信者を作成してシェアに追加します。シェアと受信者は、アクセス許可モデルを使用してアクセスを制御できます。
受信者をアクティブ化します。

「データ共有」ページから、AIデータ・プラットフォーム内のすべての共有、AIデータ・プラットフォーム内のすべての共有の受信者、共有および他の共有によって受信者が確認できます。

「共有」タブから、AIデータ・プラットフォームの共有の詳細(共有内のアセット数、受信者数、共有を所有するユーザーなど)を確認できます。検索バーの隣にある「共有の作成」をクリックすると、新しい共有を作成できます。

共有をクリックすると、共有アセット、受信者、詳細およびRBAC権限を表示できます。「アセット」タブから、アセットを共有に追加できます。「受信者」タブから、この特定の共有の受信者を管理したり、新しい受信者を作成したり、既存の受信者と共有したりできます。「詳細」タブには、シェアの名前、説明、および作成の詳細が表示されます。「アクセス権」タブから、そのシェアのRBAC権限を管理できます。

データ共有の最上位レベルの「受信者」タブから、AIデータ・プラットフォームで共有受信者の詳細を確認できます。検索バーの隣にある「受信者の作成」をクリックすると、新しい受信者を作成できます。

受信者名をクリックすると、受信者が追加されたシェア、その受信者の詳細、およびその受信者のRBACアクセス権が表示されます。

デルタ共有の消費

delta_sharingライブラリをインポートすることで、Pythonを使用してAIデータ・プラットフォームでデルタ共有を使用できます。コードを実行する前に、ユーザーはDelt@シェアをアクティブにして、生成されたプロファイルファイルをワークスペースに保存する必要があります。プロファイル・ファイルは、デルタ共有クライアントが共有表を認証およびアクセスするために使用します。

import delta_sharing

# Path to your downloaded credentials file
profile_file = "<<path to the share file in workspace>>"

# Initialize the client
client = delta_sharing.SharingClient(profile_file)

#List all schemas and tables available to you
tables = client.list_all_tables()
print("Available Tables:", tables)

手数料トークン失効

AI Data Platformは、アクティブな受信者のデータ共有のためにベアラー・トークンを再生成できます。現在のBearerトークンが期限切れになっていない場合は、curlコマンドを使用してupdateSecretExpiry APIをコールすることで、Bearerトークンの期間を延長できます。

curl
    --header 'Authorization: Bearer <token>’
    --header 'Content-Type: application/json'
    --data '{"existingTokenExpireInSeconds":"<duration>"}'
    --request POST ‘<delta_share_endpoint>/updateSecretExpiry'

説明:

<token>は、シェアプロファイルのBearerトークン値です
<duration>は、新しいトークンの期間(秒)です
<delta_share_endpoint>はデルタ共有エンドポイントです。sql("DESCRIBE recipient <<recipient_name>>")を使用して受信者のdelta_share_enpointの値を確認することで、受信者のこの値を取得できます。

制限事項

アクティブ化トークン電子メールは、電子メール・アプリケーションを使用して送信するか、アクティブ化リンクをコピーして、既存の電子メール・サービスを使用して電子メールを作成できます。
データ共有を使用して、ボリュームまたはワークスペース・ファイル(データ、ノートブック、SQLまたはpythonファイル)を共有することはできません。

シェアの作成

共有は、Oracle AI Data Platformデータ共有の一部として共有アセットを管理するためのコンテナとして作成する必要があります。

ホーム・ページで、「データ共有」をクリックします。
「共有の作成」をクリックします。
共有の名前と説明を入力します。
「作成」をクリックします。

共有の変更

作成後に、シェアの名前および説明を更新できます。

ホーム・ページで、「データ共有」をクリックします。
変更するシェアの横にある「アクション」をクリックし、「編集」をクリックします。
共有の新しい名前または説明を入力します。「保存」をクリックします

共有の削除

不要になった共有は削除できます。

ホーム・ページで、「データ共有」をクリックします。
削除するシェアの横にある「アクション」をクリックし、「削除」をクリックします。
「削除」をクリックします

共有詳細の表示

アセット、シェアにアクセスできるユーザーなど、シェアに関する詳細を表示できます。

ホーム・ページで、「データ共有」をクリックします。
「Shares」タブをクリックします。
シェア名をクリックし、「詳細」タブをクリックします。

アセットを共有に追加する

共有を作成した後、受信者と共有するアセットを追加できます。

ホーム・ページで、「データ共有」をクリックします。
アセットを追加する共有の名前をクリックします。
「アセット」タブで、「アセットの追加」をクリックします。
アセット・ソースとして「ワークスペース」または「カタログ」を選択します。
検索バーを使用するか、共有するアセットに移動します。これを選択して、「追加」をクリックします。

共有からのアセットの削除

共有の一部にする必要がなくなったアセットを削除できます。

ホーム・ページで、「データ共有」をクリックします。
アセットを削除する共有の名前をクリックします。
「アセット」タブで、削除するアセットの横にある「アクション」をクリックし、「削除」をクリックします。
「削除」をクリックします

データ共有への受信者の追加

受信者をシェアに含める前に、受信者を追加する必要があります。

ホーム・ページで、「データ共有」をクリックします。
「受信者」タブをクリックします。
「受信者の作成」をクリックします。
受取人の名前と説明を入力します。
オプション: 受信者のアクティブ化リンクを送信する電子メール・アドレスを入力します。
「作成」をクリックします。

共有への既存の受信者の追加

Oracle AI Data Platformにすでに存在する受信者を共有に追加できます。

ホーム・ページで、「データ共有」をクリックします。
既存の受信者を追加する共有の名前をクリックします。
「受信者」タブをクリックします。
「既存の受信者と共有」をクリックします。
ユーザーを検索し、受信者名の横にあるボックスを選択します。
「共有」をクリックします。

受取人の手動アクティブ化

電子メールのアクティブ化リンクを使用できない問題がある場合は、受信者を手動でアクティブ化できます。

ホーム・ページで、「データ共有」をクリックします。
「受信者」タブをクリックします。
受信者名をクリックし、「詳細」タブをクリックします。
「アクティブ化ステータス」の横にある「アクティブ化」をクリックします。
プロンプトからアクティブ化リンクをコピーし、別のウィンドウに貼り付けます。
「アクティブ化」ステータスが「アクティブ」に設定されていることを確認します。

アクティブ化リンクを受信者に再送信

アクティブ化リンクが紛失、削除、または受信者によって受信されなかった場合は、指定した電子メール・アドレスにアクティブ化リンクを再送信できます。

受信者にアクティブ化リンクを送信するには、詳細の一部として電子メール・アドレスが必要です。Eメールが正しくないか欠落している場合は、新しい受信者を作成する必要がある場合があります。

ホーム・ページで、「データ共有」をクリックします。
「受信者」タブをクリックします。
受信者名をクリックし、「詳細」タブをクリックします。
「アクティブ化電子メール・リンク」の横にある「アクティブ化リンクの送信」をクリックします。構成済の電子メール・アプリケーションが開きます。
Eメールをレビューして、受信者に送信します。

共有からの受信者の削除

共有から受信者を削除して、受信者はその共有内のアセットへのアクセス権を削除したままにしておくことができます。

ホーム・ページで、「データ共有」をクリックします。
受信者を削除するシェアをクリックします。
「受信者」タブをクリックします。
削除する受信者の横にある「アクション」をクリックし、「削除」をクリックします。

受信者の変更

作成後に、受信者の名前、説明および電子メール・アドレスを更新できます。

ホーム・ページで、「データ共有」をクリックします。
「受信者」タブをクリックします。
更新する受信者の横にある「アクション」をクリックし、「編集」をクリックします。
受信者の新しい名前または説明を入力します。「保存」をクリックします

受取者詳細の表示

「詳細」タブから、名前、アクティブ化リンクの電子メール・アドレス、アクティブ・ステータス、作成詳細などの受信者に関する情報を表示できます。

ホーム・ページで、「データ共有」をクリックします。
「受信者」タブをクリックします。
受信者名をクリックし、「詳細」タブをクリックします。

受信者の削除

Oracle AI Data Platformで不要になった受信者を削除できます。

ホーム・ページで、「データ共有」をクリックします。
「受信者」タブをクリックします。
削除する受信者の横にある「アクション」をクリックし、「削除」をクリックします。
「削除」をクリックします

32 データの共有