Azure Data FactoryとAzure Synapse Analyticsでリンクされたサービスをパラメーター化する

適用対象: Azure Data Factory Azure Synapse Analytics

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

Azure ポータルまたはプログラミング インターフェイスで UI を使用して、リンクされたサービスをパラメーター化できます。

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

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

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

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

• Amazon Redshift
• アマゾンS3
• Amazon S3 互換ストレージ
• Azure Blob Storage (アジュール ブロブ ストレージ)
• NoSQLのAzure Cosmos DB
• Azure Databricks デルタ レイク
• Azure Data Explorer
• Azure Data Lake Storage Gen1
• Azure Data Lake Storage Gen2
• Azure Database for MySQL (MySQL用Azureデータベース)
• Azure Database for PostgreSQL（アジュール データベース フォー ポストグレスキューエル）
• Azure Databricks
• Azure ファイル ストレージ
• 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 ビッグクエリ（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 オンライン リスト
• Snowflake
• SQL Server
• Vertica

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

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

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

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に資格情報を保存する