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

[アーティクル]
01/29/2024

適用対象: 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 テーブル
SFTP
SharePoint Online リスト
Snowflake
SQL Server

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

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

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

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 Data Factory および Azure Synapse Analytics のリンクされたサービスをパラメーター化する

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

UI エクスペリエンス

JSON

その他のリソース