データ共有関数

Data Share関数のPython Data Studioアプリケーション・プログラミング・インタフェース(API)は、Data Studioツール・スイートのデータ共有ツールに対するアプリケーション・プログラミング・インタフェースのクラス、メソッド、属性およびパラメータの構文と説明を提供します。

Data Studioデータ共有API関数

Adp.Shareクラスは、データ共有の操作に使用されます。このクラスには、データ共有や受信者などを管理できるデータ共有機能のセットが含まれています。

前提条件

最初にADPインスタンスを作成する必要があります。

関数には、文字列の戻り値と文字列パラメータがあります。

共有プロシージャの作成

この関数は、オブジェクト・ストレージ日付に基づいてデータ共有を作成し、受信者に関連付けます。

構文

Share.create_share(name, objects, storage_link_name, publish_job_details, owner, type,
      storage_link_owner, description)
パラメータと説明は次のとおりです。
  • name: データ共有の名前。このフィールドは必須です。
  • オブジェクト: データ共有オブジェクト・ディクショナリは次のフィールドで構成されます。
    • [{"schemaName" : "schemaNameValue", "objects": [{"objectName": "objectNameValue", "objectOwner": "objectOwnerValue", "shareObjectName": "shareObjectNameValue}, ...]}, ...]]

    このフィールドは必須です。

  • storage_link_name: このフィールドには、データ共有クラウドストレージリンク名が表示されます。
  • publish_job_details: このフィールドには、データ共有公開ジョブ詳細ディクショナリが表示されます。このフィールドがない場合、{"enabled": False}が使用されます。
  • owner: このフィールドには、データ共有所有者が表示されます。このフィールドがない場合、ツールは現在のスキーマ所有者を使用します。
  • type: データ共有のタイプ。このフィールドがない場合、ツールはVERSIONEDフィールドを使用します。
  • storage_link_owner: データ共有クラウドストレージリンク所有者。このフィールドがない場合、ツールは現在のスキーマ所有者を使用します。
  • description: このフィールドには、データ共有の説明が表示されます。このフィールドがない場合、ツールでは空の文字列が使用されます。

例
この例では、データ共有を作成できます。
name = 'share_py_api_7'
desc = 'desc_share_py_api_7'
link = '"food_cred"'
share_objects = json.dumps([{"schemaName" : "ADMIN",
           "objects" : [{"objectName"      : "IRIS",
                         "objectOwner"     : "ADMIN",
                         "shareObjectName" : "IRIS_SHARE"},
                        {"objectName"      : "DEMO_FOOD_SAMPLE",
                         "objectOwner"     : "ADMIN",
                         "shareObjectName" : "DEMO_FOOD_SAMPLE_SHARE"}
                         ]}])
job = json.dumps({"enabled" : False})

adp.Share.create_share(
    name                = name,
    description         = desc,
    storage_link_name   = link,
    objects             = share_objects,
    publish_job_details = job)

//Output:
{"createdShare":true,"notifyRecipients":false,"shareId":40295,"sharetablename_":"DEMO_FOOD_SAMPLE_SHARE"}

データ共有オブジェクトの更新手順

この関数は、データ共有オブジェクトを更新します。

構文

Share.update_share_objects(name, objects, publish_job_details, owner,
    description)
パラメータと説明は次のとおりです。
  • name: データ共有の名前。このフィールドは必須です。
  • オブジェクト: データ共有オブジェクト・ディクショナリは次のフィールドで構成されます。
    • [{"schemaName" : "schemaNameValue", "objects": [{"objectName": "objectNameValue", "objectOwner": "objectOwnerValue", "shareObjectName": "shareObjectNameValue}, ...]}, ...]]

    このフィールドは必須です。

  • publish_job_details: このフィールドには、データ共有公開ジョブ詳細ディクショナリが表示されます。このフィールドがない場合、{"enabled": False}が使用されます。
  • owner: このフィールドには、データ共有所有者が表示されます。このフィールドがない場合、ツールは現在のスキーマ所有者を使用します。
  • description: このフィールドには、データ共有の説明が表示されます。このフィールドがない場合、ツールでは空の文字列が使用されます。

例
この例では、データ共有オブジェクトを更新できます。
name = 'share_py_api_7'
objects = json.dumps([{"schemaName" : "ADMIN",
           "objects" : [{"objectName"      : "WINE",
                         "objectOwner"     : "ADMIN",
                         "shareObjectName" : "WINE_SHARE"}
                         ]}])

adp.Share.update_share_objects(name = name, objects = objects)

//Output:
'{"sharetablename_":"WINE_SHARE"}'

データ共有の削除プロシージャ

この関数は、データ共有を削除します。

構文

Share.delete_share(name, owner)
パラメータと説明は次のとおりです。
  • name: データ共有の名前。このフィールドは必須です。
  • owner: このフィールドには、データ共有所有者が表示されます。このフィールドがない場合、ツールは現在のスキーマ所有者を使用します。

例
この例では、データ共有オブジェクトを削除できます。
adp.Share.delete_share('share_py_api_7_1')

//Output:
'{"deletedShare":true}'

データ共有プロシージャの名前変更

このファンクションは、データ共有の名前を変更します。

構文

Share.rename_share(name, new_name, owner)
パラメータと説明は次のとおりです。
  • name: データ共有の名前。このフィールドは必須です。
  • new_name: データ共有の新しい名前。このフィールドは必須です。
  • owner: このフィールドには、データ共有所有者が表示されます。このフィールドがない場合、ツールは現在のスキーマ所有者を使用します。

例
この例では、データ共有の名前を変更できます。
adp.Share.rename_share (name = 'share_py_api_7', new_name = 'share_py_api_7_1')

'{ "status": true }'

データ共有プロシージャの公開

この関数は、データ共有を公開します。

構文

Share.publish_share(name, owner)
パラメータと説明は次のとおりです。
  • name: データ共有の名前。このフィールドは必須です。
  • owner: このフィールドには、データ共有所有者が表示されます。このフィールドがない場合、ツールは現在のスキーマ所有者を使用します。

例
この例では、データ共有を公開できます。
adp.Share.publish_share(name='share_py_api_7_1')
//Output:
'{"publishShare":true}'

データ共有の非公開

この関数は、データ共有を公開します。

構文

Share.unpublish_share(name, owner)
パラメータと説明は次のとおりです。
  • name: データ共有の名前。このフィールドは必須です。
  • owner: このフィールドには、データ共有所有者が表示されます。このフィールドがない場合、ツールは現在のスキーマ所有者を使用します。

例
この例では、データ共有を非公開にできます。
adp.Share.unpublish_share(name ='share_py_api_7_1')

//Output:
'{"unpublishShare":true}'

共有プロシージャの取得

この関数は、データ共有の詳細を受け取ります。

構文

Share.get_share(name, owner)
パラメータと説明は次のとおりです。
  • name: データ共有の名前。このフィールドは必須です。
  • owner: このフィールドには、データ共有所有者が表示されます。このフィールドがない場合、ツールは現在のスキーマ所有者を使用します。

例
この例では、データ共有の詳細を受信できます。
s = adp.Share.get_share(name = 'share_py_api_7_1')
json.loads(s)

//Output:
{'id': 40415,
 'name': 'SHARE_PY_API_7_1',
 'owner': 'ADMIN',
 'description': 'desc_share_py_api_7',
 'publicDescription': 'desc_share_py_api_7',
 'type': 'VERSIONED',
 'version': None,
 'tablesCount': 3,
 'recipientsCount': 0,
 'lastExportTime': None,
 'objects': [{'id': 40416,
   'schemaName': 'ADMIN',
   'objects': [{'id': 40435,
     'shareObjectName': 'WINE_SHARE',
     'objectName': 'WINE',
     'objectOwner': 'ADMIN',
     'objectType': 'TABLE'},
    {'id': 40417,
     'shareObjectName': 'IRIS_SHARE',
     'objectName': 'IRIS',
     'objectOwner': 'ADMIN',
     'objectType': 'TABLE'},
    {'id': 40418,
     'shareObjectName': 'DEMO_FOOD_SAMPLE_SHARE',
     'objectName': 'DEMO_FOOD_SAMPLE',
     'objectOwner': 'ADMIN',
     'objectType': 'TABLE'}]}],
 'recipients': None,
 'storageLinkName': 'food_cred',
 'schedule': {'enabled': 'FALSE',
  'startDate': None,
  'endDate': None,
  'repeatInterval': None}}

シェアの取得手順

この関数は、データ共有の所有者に基づいてデータ共有リストを受信します。

構文

Share.get_shares(owner)
パラメータと説明は次のとおりです。
  • owner: このフィールドには、データ共有所有者が表示されます。このフィールドがない場合、ツールは現在のスキーマ所有者を使用します。

例
この例では、「Data Share」リストを受信できます。
s = adp.Share.get_shares()
json.loads(s)

//Output:
[{'id': 40415,
  'name': 'SHARE_PY_API_7_1',
  'owner': 'ADMIN',
  'description': 'desc_share_py_api_7',
  'type': 'VERSIONED',
  'tablesCount': 3,
  'version': None}]
次に示す手順を説明するトピックも表示できます。

親トピック: Autonomous Database用のPython Data Studio APIの使用