共有の消費

プロバイダがオブジェクトを共有したら、受信者が共有を消費するために従う必要があります。

「共有の消費」ページを使用して、次の操作を実行します。
  • 共有の概要の消費:

    データ共有を使用するには、データ共有をサブスクライブし、ライブ共有に含まれる表のビューを作成する必要があります。

  • バージョン管理された共有の消費:

    受信者は、共有プロファイルをダウンロードし、データ共有プロバイダにサブスクライブし、共有を登録して、共有上に外部表を作成する必要があります。データ共有ツールは、アクティブ化メールによって受信者に送信されるJSONプロファイルを使用してアクセスを承認します。アクセス権が付与されると、データ共有ツールが共有オブジェクトを「データ」リンク・ツールにリンクします。このツールでは、コンシューマはデータ・リンク・ジョブを実行し、プロバイダが共有するオブジェクトにアクセスできます。

  • ライブ共有の消費:

    これにより、受信者はデータベースからのライブ・データを消費できます。

  • 共有プロバイダ・エンティティ詳細の表示:

    ライブ共有またはデルタ共有プロバイダ・エンティティ・エントリの右側にある「アクション」アイコンを使用して、作成したライブ共有またはデルタ共有プロバイダ・エンティティの詳細を表示します。

共有概要の消費

「共有の消費」には、共有プロバイダのリストの概要、共有プロバイダの検索および共有プロバイダの追加が表示されます。

「共有の消費」ページに移動するには、次のいずれかを実行します。
  • Data Studioのメニューで、「データ共有」メニューの「共有の消費」を選択します。
  • 「データ共有」ページで、「プロバイダおよびコンシューマ」セクションにある「共有の消費」ウィジェットをクリックします。

「共有の消費」ページには次のものが含まれます。consumption-share-new.pngの説明が続きます

  1. 過去7日間の使用可能なライブ共有プロバイダ

    この領域には、過去7日間に作成した使用可能なライブ・シェア・プロバイダのリストが表示されます。任意のフィールドを必要に応じて更新できます。「過去7日間の使用可能なシェア」にリストされているシェアの右側にある+記号を使用して、ライブ・シェアをサブスクライブすることもできます。

  2. 「サブスクライブ済共有プロバイダの検索」フィールド

    作成した共有受信者を検索するには、サブスクライブした共有プロバイダの名前を入力します。サブスクライブされた共有プロバイダの名前(REVIEW_PROVIDERなど)を入力し、拡大鏡アイコンをクリックして検索を完了します。共有ツールは、表示領域に検索結果を表示します。

  3. +共有プロバイダへのサブスクライブを選択して、新しい共有プロバイダにサブスクライブします。このアイコンの詳細は、共有プロバイダへのサブスクライブを参照してください。
  4. 自分の共有ID

    共有IDは、Autonomous Databaseの一意のプロバイダです。このIDをクリップボードにコピーし、「共有受信者の作成」ウィザードの「共有ID」フィールドに貼り付けます。これにより、ライブシェアを共有プロバイダと共有できます。

  5. ツールバー

    ツールバーは、「ソート基準」、「ページ・サイズ」、「リフレッシュ」および「エンティティ・ビュー」オプションで構成されます。

  6. 設定でソート

    ツールバーの「ソート基準」コントロールを使用してソート値を設定すると、設定がツールバーの下の小さいボックスに表示されます。設定を削除するには、ボックスの「X」アイコンをクリックします。または、ツールバーの「ソート基準」コントロールに戻って設定を変更できます。

  7. 表示領域

    コンシューマ共有プロバイダの検索フィールドの下の領域には、検索から返され、「フィルタ」パネルに設定したフィルタ基準と一致するエンティティが表示されます。エンティティは、「ソート基準」ボタンをクリックしてソート値を設定することでソートできます。

バージョン管理された共有の消費

Oracle Autonomous Database内で共有バージョン管理データを使用できるようにするには、次のステップに従う必要があります。デルタ共有を介して共有されるデータは、Autonomous Databaseで自動的に使用可能で検出できません。

提供されたデータ共有をサブスクライブしてアクセスするには、いくつかの基本的なステップを実行する必要があります。実行するステップは、次のとおりです。
  • JSONプロファイルをダウンロードします。
  • データ共有プロバイダをサブスクライブします。
  • 利用可能になったシェアを登録します。
  • 共有の上に外部表を作成します。

JSONプロファイルについて

プロファイル・ファイルは、Delta共有サーバーにアクセスするためのユーザーの資格証明を含むJSONファイルです。これにより、デルタ共有サーバーを使用して自身を認証し、アクセスに適格なデータ共有を検出できます。データ共有プロバイダによって送信された招待Eメールに含まれるURLを使用して、プロファイルをダウンロードします。

共有ツールで共有オブジェクトを作成すると、受信者はOracle Autonomous Databaseデータ共有という件名でアクティブ化メールを受信します。


activation-mail-new.pngの説明が続きます

共有にアクセスするには、個人認可JSONプロファイルを使用して共有オブジェクトを登録する必要があります。

プロファイル・リンクをクリックすると、JSONプロファイルをダウンロードできます。プロファイル・リンクをクリックすると、次に示すプロファイル情報の取得ボタンが表示されたブラウザの新しい画面に移動します。

json-profile.pngの説明が続きます
プロファイル情報の取得を選択してJSONプロファイルをダウンロードし、共有プロバイダに接続します。
ノート

「プロファイル情報の取得」ボタンは1回のみクリックでき、クイック・スタート・ガイドへのリンクも表示できます。共有ツールでは、プロファイル情報の取得を2回選択できません。これを2回クリックすると、プロファイルのダウンロードが失敗した原因のリストを示す画面が表示されます。
次のプロファイルは、ダウンロードするJSONプロファイルの例です。
{  "
        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": "2023-01-13T07:53:11.073Z", 
        "clientID": "xxxxxxxxxxxxxxxxxxxxxx..", 
        "clientSecret": "xxxxxxxxxxxxxxxxxxxx.."}
プロファイルには、暗号化された形式で資格証明が格納されます。パラメータとその説明は次のとおりです。
  • shareCredentialsVersion:公開する共有のバージョン。
  • endpoint:共有エンドポイントを指定します。
  • tokenEndpoint:トークン・エンドポイントを指定します。共有ツール・クライアントはトークン・エンドポイントを使用して、Oracleを使用して共有を使用している場合、Bearerトークンのタイムアウトをリフレッシュします。
  • bearerToken:これは、ログイン・リクエストに応答して認証サーバーが生成する暗号化文字列です。
  • expirationTime:認証が期限切れになるまでにかかった時間です。
  • ClientID:認証のためにインスタンスを登録する際、認証サーバーが生成する公開識別子を指定します。
  • clientSecret:認証サーバーが認可のために生成するシークレット識別子を指定します。
プロファイルのJSONコンテンツをメモ帳にコピーします。共有プロバイダをサブスクライブするには、次のJSONが必要です。
ノート

左右の中カッコを含め、完全なJSONコンテンツ・プロファイルをコピーしてください。

セキュリティ拡張機能

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

ノート

これは、「共有プロバイダの追加」ウィザードで、ホスト(つまり、共有プロバイダ)のアクセス制御リスト(ACL)にアクセス制御エントリ(ACE)を追加する前に行う必要があります。ホスト名は前のステップでダウンロードしたJSONプロファイルから検索できます。

たとえば、データベース・ユーザー、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パッケージ・アンド・タイプ・リファレンスのドキュメントを参照してください。

ローカルORDSエンドポイントでユーザーにACLを付与します。ローカルに作成された共有でベアラー・トークンを生成するには、これが必要です。
PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

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

  1. 「共有の消費」ページを開き、+共有プロバイダへのサブスクライブをクリックして、ドロップダウンからデルタ共有プロバイダへのサブスクライブを選択します。これにより、「共有プロバイダへのサブスクライブ」ダイアログ・ボックスが開きます。
  2. 「共有プロバイダの登録」ダイアログ・ボックスの「プロバイダ設定」ペインで、次の詳細を指定します。subscribe-share-provider-version-providersettings.pngの説明が続きます
    • プロバイダ名: プロバイダ
    • 説明: 説明を追加します。このフィールドはオプションです。

    「ソースの共有」セクションで、「プロバイダのJSONのデルタ共有」を選択します。

    「共有プロバイダJSON」フィールドでは、次の方法でJSONプロファイルを共有できます。
    • ファイルから: このオプションを選択し、「デルタ共有プロファイルJSON」というドロップ領域をクリックします。領域をクリックすると、ダウンロードしたJSONプロファイルを選択できるローカル・リポジトリが開きます。
    • JSON: このオプションを選択し、コピーするプロファイルのJSONコンテンツをメモ帳にペーストできます。

    JSONプロファイル・ファイルをアップロードし、共有プロバイダ・サブスクリプションを作成します。

    「次」をクリックして、「共有の追加」タブをクリックします。
  3. ダイアログの「共有の追加」タブで、使用可能な共有のリストを表示します。「使用可能な共有」から消費する共有をクリックし、使用可能なオプションのいずれかを選択します。subscribe-share-provider-version-addshares.pngの説明が続きます
    • >: このオプションを使用すると、「使用可能な共有」を「選択した共有」に移動できます。
    • <: このオプションは、選択した共有を「選択した共有」から削除する場合に選択します。
    • >>: このオプションを使用すると、すべての共有を「選択した共有」画面に移動できます。
    • <<: 選択した共有を「選択した共有」からすべて削除するには、このオプションを選択します。
  4. 「サブスクライブ」をクリックして、共有を追加します。プロバイダが正常に作成されると、確認プロンプトが表示されます。プロバイダが正常に作成されると、「データ・ロード」ページの「クラウド・オブジェクトのリンク」画面が表示されます。

  5. 「Cloud Storage Location」フィールドに共有プロバイダの名前を表示できます。シェアが、シェアに追加したファイルとともにソースファイルの場所に表示されます。link-cloud-object.pngの説明が続きます

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

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

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

      表のSQL Select文が表示されます。このSQL文は、共有データを消費するために実行できます。

      xt_sql.pngの説明が続きます

ライブ共有の消費

データ共有を通じて共有されるライブ・データは、自動的に使用できなくなります。

ライブ・データ共有を使用するには、ライブ・データ共有をサブスクライブし、ライブ共有に含まれる表のビューを作成する必要があります。ビューは、SQLスクリプトを使用して問い合せることができます。

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

    「ソースの共有」セクションで、「ライブ共有プロバイダからの選択」を選択し、ドロップダウンからプロバイダを選択します。

    「共有プロバイダの詳細」フィールドで、次のように入力します。
    • プロバイダ名: プロバイダの名前を指定します。
    • 説明: プロバイダの説明を入力します。

    「次」をクリックして、「共有の追加」タブをクリックします。

  3. ダイアログの「共有の追加」タブで、使用可能な共有のリストを表示します。「使用可能な共有」から消費する共有をクリックし、使用可能なオプションのいずれかを選択します。add-shares.pngの説明が続きます
    • >: このオプションを使用すると、「使用可能な共有」を「選択した共有」に移動できます。
    • <: このオプションは、選択した共有を「選択した共有」から削除する場合に選択します。
    • >>: このオプションを使用すると、すべての共有を「選択した共有」画面に移動できます。
    • <<: 選択した共有を「選択した共有」からすべて削除するには、このオプションを選択します。

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

  4. 「Cloud Storage Location」フィールドに共有プロバイダの名前を表示できます。シェアが、シェアに追加したファイルとともにソースファイルの場所に表示されます。link-cloud-object.pngの説明が続きます

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

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

共有プロバイダ・エンティティ詳細の表示

共有プロバイダ・エンティティの詳細を表示するには、共有プロバイダ・エンティティ・エントリの右側にある「アクション」アイコンをクリックして、「詳細の表示」をクリックします。

すべてのエンティティについて、詳細には「系統」セクションと「影響」セクションが含まれます。

特定の共有プロバイダ・エンティティについては、「アクション」コンテキスト・メニューを使用して次のアクションを実行できます。

  • 詳細の表示:詳細は、共有プロバイダ・エンティティ詳細の表示を参照してください。
  • 共有の管理:共有プロバイダの共有の管理ダイアログ・ボックスが開きます。受信者と共有するために選択した共有がリストされます。受信者と共有する共有のリストを編集できます。「OK」をクリックして変更を保存するか、「取消」を選択して編集処理を破棄します。
  • 名前の変更:プロバイダ名を変更します。「はい」を選択して変更するか、「いいえ」をクリックします。
  • 削除:共有プロバイダ・エンティティを削除します。
  • 表のロード:「共有」タブが選択された状態で「データのロード」ページが表示されます。
  • リンク表:「共有」タブが選択された状態で「データのリンク」ページに移動し、関連するリンク・オブジェクトを表示および実行します。共有データをドラッグ・アンド・ドロップして、データ・リンク・ジョブに追加します。