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"
}
}
}
}