7 データの共有

この章では、AIデータ・プラットフォーム・ワークベンチでのデータ共有、アセットおよび受信者の管理について詳しく説明します。

データ共有

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

AI Data Platform Workbenchは、Delta Sharingプロトコルを使用してデータを安全に共有します。データを共有するには、次のステップを完了する必要があります。
  1. シェアを作成します。
  2. 共有するアセットを追加します。アセットには、スキーマまたは表を指定できます。
  3. 受信者を作成してシェアに追加します。シェアと受信者は、アクセス許可モデルを使用してアクセスを制御できます。
  4. 受信者をアクティブ化します。

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

「シェア」タブから、シェア内のアセット数、受信者数、シェアを所有するユーザーなど、AI Data Platform Workbenchでシェアの詳細を表示できます。検索バーの隣にある「共有の作成」をクリックすると、新しい共有を作成できます。

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

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

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

手数料トークン失効

Oracle 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ファイル)を共有することはできません。

シェアの作成

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

  1. ホーム・ページで、「データ共有」をクリックします。
  2. 「共有の作成」アイコン 「共有の作成」をクリックします。
  3. 共有の名前と説明を入力します。
  4. 「作成」をクリックします。

共有の変更

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

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

共有の削除

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

  1. ホーム・ページで、「データ共有」をクリックします。
  2. 削除するシェアの横にあるアクションの3つのドット・アイコン 「アクション」をクリックし、「削除」をクリックします。
  3. 「削除」をクリックします

共有詳細の表示

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

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

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

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

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

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

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

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

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

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

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

AIデータ・プラットフォーム・ワークベンチにすでに存在する受信者を共有に追加できます。

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

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

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

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

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

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

受信者にアクティブ化リンクを送信するには、詳細の一部として電子メール・アドレスが必要です。Eメールが正しくないか欠落している場合は、新しい受信者を作成する必要がある場合があります。
  1. ホーム・ページで、「データ共有」をクリックします。
  2. 「受信者」タブをクリックします。
  3. 受信者名をクリックし、「詳細」タブをクリックします。
  4. 「アクティブ化電子メール・リンク」の横にある「アクティブ化リンクの送信」をクリックします。構成済の電子メール・アプリケーションが開きます。
  5. Eメールをレビューして、受信者に送信します。

共有からの受信者の削除

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

  1. ホーム・ページで、「データ共有」をクリックします。
  2. 受信者を削除するシェアをクリックします。
  3. 「受信者」タブをクリックします。
  4. 削除する受信者の横にあるアクションの3つのドット・アイコン 「アクション」をクリックし、「削除」をクリックします。

受信者の変更

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

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

受取者詳細の表示

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

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

受信者の削除

AIデータ・プラットフォーム・ワークベンチで不要になった受信者を削除できます。

  1. ホーム・ページで、「データ共有」をクリックします。
  2. 「受信者」タブをクリックします。
  3. 削除する受信者の横にあるアクションの3つのドット・アイコン 「アクション」をクリックし、「削除」をクリックします。
  4. 「削除」をクリックします