Python 用 Azure Purview Workflow Service クライアント ライブラリ - バージョン 1.0.0b2

  • [アーティクル]

ワークフローは自動化された反復可能なビジネス プロセスであり、ユーザーは Microsoft Purview 内に作成して、データ エンティティに対する CUD (作成、更新、削除) 操作を検証し、調整することができます。 これらのプロセスを有効にすると、組織は変更を追跡し、ポリシー準拠を強制し、データ ランドスケープ全体の品質の高いデータを確保できます。

Purview Workflow のクライアント ライブラリを使用して、次の作業を行います。

  • ワークフローの管理
  • ユーザー要求を送信し、ワークフローの実行を監視する
  • ワークフロー タスクの表示と対応

ワークフローの使用方法の詳細については、サービスのドキュメントを参照してください

作業の開始

前提条件

認証

AAD で認証するには、最初に pip をインストールする必要があります azure-identity

セットアップ後、使用する azure.identity から 資格情報 の種類を選択できます。 ワークフロー サービスの場合は、 UsernamePasswordCredential を 使用してクライアントを認証することをお勧めします。

AAD アプリケーションのクライアント ID とテナント ID の値を設定し、AAD ユーザーのユーザー名とパスワードの値を環境変数として設定します。 AZURE_CLIENT_IDAZURE_TENANT_IDUSERNAMEPASSWORD

返されたトークン資格情報を使用して、クライアントを認証します。

from azure.purview.workflow import PurviewWorkflowClient
from azure.identity import UsernamePasswordCredential
username = os.getenv("USERNAME")
password = os.getenv("PASSWORD")
client_id = os.getenv("AZURE_CLIENT_ID")
tenant_id = os.getenv("AZURE_TENANT_ID")
credential = UsernamePasswordCredential(client_id=client_id, username=username, password=password, tenant_id=tenant_id)
client = PurviewWorkflowClient(endpoint='<endpoint>', credential=credential)

例

次のセクションでは、クライアントを初期化して認証し、すべてのワークフローを一覧表示する方法を示します。

すべてのワークフローを一覧表示する

from azure.purview.workflow import PurviewWorkflowClient
from azure.identity import UsernamePasswordCredential
username = os.getenv("USERNAME")
password = os.getenv("PASSWORD")
client_id = os.getenv("AZURE_CLIENT_ID")
tenant_id = os.getenv("AZURE_TENANT_ID")
credential = UsernamePasswordCredential(client_id=client_id, username=username, password=password, tenant_id=tenant_id)
client = PurviewWorkflowClient(endpoint='<endpoint>', credential=credential)
try:
    response = client.workflows.list()
    for item in response:
    print(item)
except HttpResponseError as e:
    print('service responds error: {}'.format(e.response.json()))

主要な概念

トラブルシューティング

共同作成

次のステップ

このプロジェクトでは、共同作成と提案を歓迎しています。 ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、 https://cla.microsoft.com を参照してください。

pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。 ボットによって提供される手順にそのまま従ってください。 この操作は、Microsoft の CLA を使用するすべてのリポジトリについて、1 回だけ行う必要があります。

このプロジェクトでは、Microsoft オープン ソースの倫理規定を採用しています。 詳細については、「倫理規定の FAQ」をご覧ください。追加の質問やコメントがある場合は opencode@microsoft.com にお問い合わせください。