次の方法で共有


Azure Data Factory および Azure Synapse Analytics のリンクされたサービスをパラメーター化する

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。

リンクされたサービスをパラメーター化し、実行時に動的な値を渡せるようになりました。 たとえば、同じ論理 SQL サーバー上の異なるデータベースに接続する場合に、リンクされたサービスの定義内でデータベース名をパラメーター化することができるようになりました。 これにより、論理 SQL サーバー上のデータベースごとに、リンクされたサービスを作成する必要がなくなります。 リンクされたサービスの定義内で、他のプロパティをパラメーター化することもできます (たとえば、ユーザー名など)。

リンクされたサービスをパラメーター化するには、Azure portal の UI か、プログラミング インターフェイスを使用できます。

ヒント

パスワードやシークレットはパラメーター化しないようにすることをお勧めします。 シークレットはすべて Azure Key Vault 内に格納し、シークレット名をパラメーター化するようにしてください。

注意

パラメーター名に "-" を使用する未解決のバグがあります。バグが解決されるまでは、"-" を含まない名前を使用することをお勧めします。

この機能の概要とデモンストレーションについては、以下の 7 分間の動画を視聴してください。

サポートされるリンクされたサービスの種類

すべてのリンクされたサービスの種類は、パラメーター化でサポートされています。

UI でネイティブにサポートされる: リンクされたサービスを UI で作成する場合、このサービスは、次の種類のリンクされたサービスに対して組み込みのパラメーター化エクスペリエンスを提供します。 リンクされたサービスの作成/編集ブレードで、新しいパラメーターのオプションを検索し、動的なコンテンツを追加できます。 「UI エクスペリエンス」を参照してください。

  • Amazon Redshift
  • Amazon S3
  • Amazon S3 互換ストレージ
  • Azure Blob Storage
  • NoSQL 用 Azure Cosmos DB
  • Azure Databricks Delta Lake
  • Azure Data Explorer
  • Azure Data Lake Storage Gen1
  • Azure Data Lake Storage Gen2
  • Azure Database for MySQL
  • Azure Database for PostgreSQL
  • Azure Databricks
  • Azure File Storage
  • Azure 関数
  • Azure Key Vault
  • Azure SQL Database
  • Azure SQL Managed Instance
  • Azure Synapse Analytics
  • Azure Table Storage
  • Dataverse
  • DB2
  • Dynamics 365
  • Dynamics AX
  • Dynamics CRM
  • ファイル システム
  • FTP
  • 汎用 HTTP
  • 汎用 REST
  • Google AdWords
  • Google BigQuery
  • Informix
  • MariaDB
  • Microsoft Access
  • MySQL
  • OData
  • ODBC
  • Oracle
  • Oracle Cloud Storage
  • PostgreSQL
  • Salesforce
  • Salesforce Service Cloud
  • SAP CDC
  • SAP HANA
  • SAP テーブル
  • ServiceNow (ServiceNow レガシではサポートされていません)
  • SFTP
  • SharePoint Online リスト
  • Snowflake
  • SQL Server

詳細作成: 上記の一覧にないその他のリンクされたサービスの種類では、UI で JSON を編集して、リンクされたサービスをパラメーター化できます。

  • リンクされたサービスの作成/編集ブレードで > 下部にある "詳細" を展開し > "JSON 形式で動的な内容を指定する" ためのチェックボックスをオンにして > リンクされたサービスの JSON ペイロードを指定します。
  • または、パラメーター化せずにリンクされたサービスを作成した後で、管理ハブ> リンクされたサービス > 特定のリンクされたサービスを検索 > "コード" (ボタン {}) をクリックして JSON を編集します。

parameters セクションを追加してパラメーターを定義し、@{linkedService().paramName} を使用してパラメーターを参照するには、JSON サンプルを参照してください。

UI エクスペリエンス

JSON

{
	"name": "AzureSqlDatabase",
	"properties": {
		"type": "AzureSqlDatabase",
		"typeProperties": {
			"connectionString": "Server=tcp:myserver.database.windows.net,1433;Database=@{linkedService().DBName};User ID=user;Password=fake;Trusted_Connection=False;Encrypt=True;Connection Timeout=30"
		},
		"connectVia": null,
		"parameters": {
			"DBName": {
				"type": "String"
			}
		}
	}
}

Azure Key Vault への資格情報の格納