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
• Vertica

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

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

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

UI エクスペリエンス

Azure Data Factory

Azure Synapse

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 への資格情報の格納