Microsoft.DataFactory Factory

發行項
03/13/2024

Bicep 資源定義

處理站資源類型可以使用目標作業來部署：

資源群組 - 請參閱資源群組部署命令

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄檔。

資源格式

若要建立 Microsoft.DataFactory/factoryies 資源，請將下列 Bicep 新增至您的範本。

resource symbolicname 'Microsoft.DataFactory/factories@2018-06-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: any()
    }
  }
  properties: {
    encryption: {
      identity: {
        userAssignedIdentity: 'string'
      }
      keyName: 'string'
      keyVersion: 'string'
      vaultBaseUrl: 'string'
    }
    globalParameters: {
      {customized property}: {
        type: 'string'
        value: any()
      }
    }
    publicNetworkAccess: 'string'
    purviewConfiguration: {
      purviewResourceId: 'string'
    }
    repoConfiguration: {
      accountName: 'string'
      collaborationBranch: 'string'
      disablePublish: bool
      lastCommitId: 'string'
      repositoryName: 'string'
      rootFolder: 'string'
      type: 'string'
      // For remaining properties, see FactoryRepoConfiguration objects
    }
  }
}

FactoryRepoConfiguration 物件

設定 type 屬性以指定物件的類型。

針對 FactoryGitHubConfiguration，請使用：

  type: 'FactoryGitHubConfiguration'
  clientId: 'string'
  clientSecret: {
    byoaSecretAkvUrl: 'string'
    byoaSecretName: 'string'
  }
  hostName: 'string'

針對 FactoryVSTSConfiguration，請使用：

  type: 'FactoryVSTSConfiguration'
  projectName: 'string'
  tenantId: 'string'

屬性值

factories

名稱	描述	值
NAME	資源名稱	需要字串 () 字元限制：3-63 合法字元：英數字元和連字號。以英數字元開頭及結尾。資源名稱在整個 Azure 中必須是唯一的。
location	資源位置。	字串
tags	資源標籤。	標記名稱和值的字典。請參閱範本中的標籤
身分識別	處理站的受控服務識別。	FactoryIdentity
properties	處理站的屬性。	FactoryProperties

FactoryIdentity

名稱	描述	值
類型	識別類型。	'SystemAssigned' 'SystemAssigned，UserAssigned' 'UserAssigned' (必要)
userAssignedIdentities	處理站的使用者指派身分識別清單。	UserAssignedIdentitiesDefinitionSpecification

UserAssignedIdentitiesDefinitionSpecification

名稱	描述	值
{自定義屬性}		針對 Bicep，您可以使用任何 () 函式。

FactoryProperties

名稱	描述	值
加密	啟用處理站客戶自控金鑰的屬性。	EncryptionConfiguration
globalParameters	Factory 的參數清單。	GlobalParameterDefinitionSpecification
publicNetworkAccess	數據處理站是否允許公用網路存取。	'Disabled' 'Enabled'
purviewConfiguration	處理站的 Purview 資訊。	PurviewConfiguration
repoConfiguration	處理站的 Git 存放庫資訊。	FactoryRepoConfiguration

EncryptionConfiguration

名稱	描述	值
身分識別	使用者指派的身分識別，用來向客戶的密鑰保存庫進行驗證。如果未提供受控服務識別，則會使用。	CMKIdentityDefinition
keyName	Azure 金鑰保存庫中用來作為客戶管理金鑰的金鑰名稱。	需要字串 ()
keyVersion	用於 CMK 的金鑰版本。如果未提供，則會使用最新版本。	字串
vaultBaseUrl	用於 CMK 的 Azure 金鑰保存庫 URL。	需要字串 ()

CMKIdentityDefinition

名稱	描述	值
userAssignedIdentity	要向客戶金鑰保存庫進行驗證之使用者指派身分識別的資源識別碼。	字串

GlobalParameterDefinitionSpecification

名稱	描述	值
{自定義屬性}		GlobalParameterSpecification

GlobalParameterSpecification

名稱	描述	值
類型	全域參數類型。	'Array' 'Bool' 'Float' 'Int' 'Object' 需要『String』 ()
值	參數的值。	針對 Bicep，您可以使用任何 () function. (所需的)

PurviewConfiguration

名稱	描述	值
purviewResourceId	Purview 資源標識碼。	字串

FactoryRepoConfiguration

名稱	描述	值
accountName	帳戶名稱。	需要字串 ()
collaborationBranch	共同作業分支。	需要字串 ()
disablePublish	停用 ADF Studio 中的手動發佈作業，以偏好自動發佈。	bool
lastCommitId	上次認可標識碼。	字串
repositoryName	存放庫名稱。	需要字串 ()
rootFolder	根資料夾。	需要字串 ()
類型	設定物件類型	FactoryGitHubConfiguration FactoryVSTSConfiguration (必要)

FactoryGitHubConfiguration

名稱	描述	值
類型	存放庫組態的類型。	'FactoryGitHubConfiguration' (必要)
clientId	GitHub 自備應用程式用戶端標識碼。	字串
clientSecret	GitHub 攜帶您自己的應用程式客戶端密碼資訊。	GitHubClientSecret
hostName	GitHub Enterprise 主機名。例如：`https://github.mydomain.com`	字串

GitHubClientSecret

名稱	描述	值
byoaSecretAkvUrl	攜帶您自己的應用程式客戶端密碼 AKV URL。	字串
byoaSecretName	在 AKV 中攜帶您自己的應用程式用戶端密碼名稱。	字串

FactoryVstsConfiguration

名稱	描述	值
類型	存放庫組態的類型。	需要『FactoryVSTSConfiguration』 ()
projectName	VSTS 項目名稱。	需要字串 ()
tenantId	VSTS 租使用者標識碼。	字串

快速入門範本

下列快速入門範本會部署此資源類型。

範本	描述
在 Azure 架構上部署運動分析	建立已啟用 ADLS Gen 2 的 Azure 記憶體帳戶、具有記憶體帳戶連結服務的 Azure Data Factory 實例， (Azure SQL 部署) 資料庫，以及 Azure Databricks 實例。部署範本的使用者 AAD 身分識別和 ADF 實例的受控識別將會獲得記憶體帳戶上的記憶體 Blob 數據參與者角色。另外還有選項可用來部署 Azure 金鑰保存庫實例、Azure SQL 資料庫，以及用於串流處理使用案例的 Azure 事件中樞 () 。部署 Azure 金鑰保存庫時，部署範本之用戶的數據處理站受控識別和 AAD 身分識別將會獲得金鑰保存庫秘密使用者角色。
FinOps 中樞	此範本會建立新的 FinOps 中樞實例，包括 Data Lake Storage 和 Data Factory。
Azure Data Factory 有更多可能 - 按兩下即可嘗試 Azure Data Factory	此範本會為從 Azure Blob 複製活動建立數據處理站管線，並將其複製到另一個 Azure Blob
建立 Data Factory，從 Salesforce 複製到 Blob	此範本會使用 Azure Data Factory 執行從 Salesforce 到 Azure Blob 的數據移動
使用 Azure Data Factory 大量複製	此範本會建立 V2 數據處理站，將大量 Azure SQL 資料庫的數據複製到 Azure SQL 數據倉儲。
建立 V2 數據處理站	此範本會建立 V2 資料處理站，將資料從 Azure Blob 儲存體的資料夾複製到記憶體中的其他資料夾。
建立 V2 Data Factory (MySQL)	此範本會建立 V2 數據處理站，將資料從 Azure Blob 儲存體的資料夾複製到適用於 MySQL 的 Azure 資料庫中的數據表。
建立 V2 Data Factory (PostGre)	此範本會建立 V2 資料處理站，將資料從 Azure Blob 儲存體中的資料夾複製到適用於 PostgreSQL 的 Azure 資料庫中的數據表。
建立 V2 Data Factory (SQL)	此範本會建立 V2 資料處理站，將資料從 Azure Blob 儲存體中的資料夾複製到 Azure SQL 資料庫中的數據表。
建立空的數據處理站	此範本會建立空的數據處理站
使用 Git 和受控 vnet 設定 Azure Data Factory	此範本會使用 Git 組態和受控虛擬網路建立 Azure Data Factory。
建立 V2 Data Factory (SQL 內部部署)	此範本會建立 V2 數據處理站，將數據從內部部署 SQL Server 複製到 Azure Blob 記憶體
在 Azure 中布建 SSIS 運行時間	此範本會建立 V2 數據處理站，然後布建 Azure SSIS 整合運行時間
建立 V2 Data Factory (Spark)	此範本會建立 V2 資料處理站，將資料從 Azure Blob 儲存體的資料夾複製到記憶體中的其他資料夾。

ARM 範本資源定義

處理站資源類型可以使用目標作業進行部署：

資源群組 - 請參閱資源群組部署命令

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄。

資源格式

若要建立 Microsoft.DataFactory/factoryies 資源，請將下列 JSON 新增至您的範本。

{
  "type": "Microsoft.DataFactory/factories",
  "apiVersion": "2018-06-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "encryption": {
      "identity": {
        "userAssignedIdentity": "string"
      },
      "keyName": "string",
      "keyVersion": "string",
      "vaultBaseUrl": "string"
    },
    "globalParameters": {
      "{customized property}": {
        "type": "string",
        "value": {}
      }
    },
    "publicNetworkAccess": "string",
    "purviewConfiguration": {
      "purviewResourceId": "string"
    },
    "repoConfiguration": {
      "accountName": "string",
      "collaborationBranch": "string",
      "disablePublish": "bool",
      "lastCommitId": "string",
      "repositoryName": "string",
      "rootFolder": "string",
      "type": "string"
      // For remaining properties, see FactoryRepoConfiguration objects
    }
  }
}

FactoryRepoConfiguration 物件

設定 type 屬性以指定物件的類型。

針對 FactoryGitHubConfiguration，請使用：

  "type": "FactoryGitHubConfiguration",
  "clientId": "string",
  "clientSecret": {
    "byoaSecretAkvUrl": "string",
    "byoaSecretName": "string"
  },
  "hostName": "string"

針對 FactoryVSTSConfiguration，請使用：

  "type": "FactoryVSTSConfiguration",
  "projectName": "string",
  "tenantId": "string"

屬性值

factories

名稱	描述	值
類型	資源類型	'Microsoft.DataFactory/factoryies'
apiVersion	資源 API 版本	'2018-06-01'
NAME	資源名稱	字串 (必要) 字元限制：3-63 合法字元：英數字元和連字號。以英數字元開頭及結尾。資源名稱在 Azure 中必須是唯一的。
location	資源位置。	字串
tags	資源標籤。	標記名稱和值的字典。請參閱範本中的標記
身分識別	處理站的受控服務識別。	FactoryIdentity
properties	處理站的屬性。	FactoryProperties

FactoryIdentity

名稱	描述	值
類型	識別類型。	'SystemAssigned' 'SystemAssigned，UserAssigned' 'UserAssigned' (必要)
userAssignedIdentities	處理站的使用者指派身分識別清單。	UserAssignedIdentitiesDefinitionSpecification

UserAssignedIdentitiesDefinitionSpecification

名稱	描述	值
{自定義屬性}

FactoryProperties

名稱	描述	值
加密	啟用處理站客戶管理金鑰的屬性。	EncryptionConfiguration
globalParameters	Factory 的參數清單。	GlobalParameterDefinitionSpecification
publicNetworkAccess	是否允許數據處理站使用公用網路存取。	'Disabled' 'Enabled'
purviewConfiguration	處理站的 Purview 資訊。	PurviewConfiguration
repoConfiguration	處理站的 Git 存放庫資訊。	FactoryRepoConfiguration

EncryptionConfiguration

名稱	描述	值
身分識別	使用者指派的身分識別，用來向客戶的密鑰保存庫進行驗證。如果未提供受控服務識別，則會使用。	CMKIdentityDefinition
keyName	Azure 中要作為客戶管理金鑰的金鑰名稱金鑰保存庫。	字串 (必要)
keyVersion	用於 CMK 的金鑰版本。如果未提供，則會使用最新版本。	字串
vaultBaseUrl	用於 CMK 的 Azure 金鑰保存庫 URL。	字串 (必要)

CMKIdentityDefinition

名稱	描述	值
userAssignedIdentity	要向客戶金鑰保存庫進行驗證之使用者指派身分識別的資源識別碼。	字串

GlobalParameterDefinitionSpecification

名稱	描述	值
{自定義屬性}		GlobalParameterSpecification

GlobalParameterSpecification

名稱	描述	值
類型	全域參數類型。	'Array' 'Bool' 'Float' 'Int' 'Object' 'String' (必要)
值	參數的值。

PurviewConfiguration

名稱	描述	值
purviewResourceId	Purview 資源標識碼。	字串

FactoryRepoConfiguration

名稱	描述	值
accountName	帳戶名稱。	字串 (必要)
collaborationBranch	共同作業分支。	字串 (必要)
disablePublish	停用 ADF Studio 中的手動發佈作業，以偏好自動發佈。	bool
lastCommitId	上次認可標識碼。	字串
repositoryName	存放庫名稱。	字串 (必要)
rootFolder	根資料夾。	字串 (必要)
類型	設定物件類型	FactoryGitHubConfiguration FactoryVSTSConfiguration (必要)

FactoryGitHubConfiguration

名稱	描述	值
類型	存放庫組態的類型。	'FactoryGitHubConfiguration' (必要)
clientId	GitHub 自備應用程式用戶端標識碼。	字串
clientSecret	GitHub 自備應用程式客戶端密碼資訊。	GitHubClientSecret
hostName	GitHub Enterprise 主機名。例如：`https://github.mydomain.com`	字串

GitHubClientSecret

名稱	描述	值
byoaSecretAkvUrl	攜帶您自己的應用程式客戶端密碼 AKV URL。	字串
byoaSecretName	在 AKV 中攜帶您自己的應用程式用戶端密碼名稱。	字串

FactoryVstsConfiguration

名稱	描述	值
類型	存放庫組態的類型。	'FactoryVSTSConfiguration' (必要)
projectName	VSTS 項目名稱。	字串 (必要)
tenantId	VSTS 租使用者標識碼。	字串

快速入門範本

下列快速入門範本會部署此資源類型。

範本	描述
在 Azure 架構上部署運動分析	建立已啟用 ADLS Gen 2 的 Azure 記憶體帳戶、具有記憶體帳戶連結服務的 Azure Data Factory 實例， (部署) Azure SQL 資料庫，以及 Azure Databricks 實例。部署範本的使用者 AAD 身分識別和 ADF 實例的受控識別將會獲得記憶體帳戶上的記憶體 Blob 數據參與者角色。另外還有選項可用來部署 Azure 金鑰保存庫實例、Azure SQL 資料庫，以及用於串流處理使用案例的 Azure 事件中樞 () 。部署 Azure 金鑰保存庫時，系統會將部署範本之使用者的 Data Factory 受控識別和 AAD 身分識別授與金鑰保存庫秘密使用者角色。
FinOps 中樞	此範本會建立新的 FinOps 中樞實例，包括 Data Lake Storage 和 Data Factory。
Azure Data Factory 有更多可能 - 按兩下即可嘗試 Azure Data Factory	此範本會為從 Azure Blob 複製活動建立數據處理站管線，並將其複製到另一個 Azure Blob
建立 Data Factory，從 Salesforce 複製到 Blob	此範本會使用 Azure Data Factory 來執行從 Salesforce 到 Azure Blob 的數據移動
使用 Azure Data Factory 大量複製	此範本會建立 V2 數據處理站，將大量 Azure SQL 資料庫的數據複製到 Azure SQL 數據倉儲。
建立 V2 數據處理站	此範本會建立 V2 資料處理站，將資料從 Azure Blob 儲存體的資料夾複製到記憶體中的其他資料夾。
建立 V2 Data Factory (MySQL)	此範本會建立 V2 數據處理站，將資料從 Azure Blob 儲存體的資料夾複製到適用於 MySQL 的 Azure 資料庫中的數據表。
建立 V2 Data Factory (PostGre)	此範本會建立 V2 資料處理站，將資料從 Azure Blob 儲存體中的資料夾複製到適用於 PostgreSQL 的 Azure 資料庫中的數據表。
建立 V2 Data Factory (SQL)	此範本會建立 V2 資料處理站，將資料從 Azure Blob 儲存體中的資料夾複製到 Azure SQL 資料庫中的數據表。
建立空的數據處理站	此範本會建立空的數據處理站
使用 Git 和受控 vnet 設定 Azure Data Factory	此範本會使用 Git 組態和受控虛擬網路建立 Azure Data Factory。
建立 V2 Data Factory (SQL 內部部署)	此範本會建立 V2 數據處理站，將數據從內部部署 SQL Server 複製到 Azure Blob 記憶體
在 Azure 中布建 SSIS 運行時間	此範本會建立 V2 數據處理站，然後布建 Azure SSIS 整合運行時間
建立 V2 Data Factory (Spark)	此範本會建立 V2 資料處理站，將資料從 Azure Blob 儲存體的資料夾複製到記憶體中的其他資料夾。

Terraform (AzAPI 提供者) 資源定義

處理站資源類型可以使用目標作業進行部署：

資源群組

如需每個 API 版本中已變更屬性的清單，請參閱變更記錄。

資源格式

若要建立 Microsoft.DataFactory/factoryies 資源，請將下列 Terraform 新增至範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DataFactory/factories@2018-06-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      encryption = {
        identity = {
          userAssignedIdentity = "string"
        }
        keyName = "string"
        keyVersion = "string"
        vaultBaseUrl = "string"
      }
      globalParameters = {
        {customized property} = {
          type = "string"
        }
      }
      publicNetworkAccess = "string"
      purviewConfiguration = {
        purviewResourceId = "string"
      }
      repoConfiguration = {
        accountName = "string"
        collaborationBranch = "string"
        disablePublish = bool
        lastCommitId = "string"
        repositoryName = "string"
        rootFolder = "string"
        type = "string"
        // For remaining properties, see FactoryRepoConfiguration objects
      }
    }
  })
}

FactoryRepoConfiguration 物件

設定 type 屬性以指定物件的類型。

針對 FactoryGitHubConfiguration，請使用：

  type = "FactoryGitHubConfiguration"
  clientId = "string"
  clientSecret = {
    byoaSecretAkvUrl = "string"
    byoaSecretName = "string"
  }
  hostName = "string"

針對 FactoryVSTSConfiguration，請使用：

  type = "FactoryVSTSConfiguration"
  projectName = "string"
  tenantId = "string"

屬性值

factories

名稱	描述	值
類型	資源類型	“Microsoft.DataFactory/factories@2018-06-01”
NAME	資源名稱	需要字串 () 字元限制：3-63 合法字元：英數字元和連字號。以英數字元開頭及結尾。資源名稱在整個 Azure 中必須是唯一的。
location	資源位置。	字串
parent_id	若要部署至資源群組，請使用該資源群組的標識碼。	需要字串 ()
tags	資源標籤。	標記名稱和值的字典。
身分識別	處理站的受控服務識別。	FactoryIdentity
properties	處理站的屬性。	FactoryProperties

FactoryIdentity

名稱	描述	值
類型	識別類型。	“SystemAssigned” “SystemAssigned，UserAssigned” “UserAssigned” (必要)
identity_ids	處理站的使用者指派身分識別清單。	使用者身分識別標識碼的陣列。

UserAssignedIdentitiesDefinitionSpecification

名稱	描述	值
{自定義屬性}

FactoryProperties

名稱	描述	值
加密	啟用處理站客戶自控金鑰的屬性。	EncryptionConfiguration
globalParameters	Factory 的參數清單。	GlobalParameterDefinitionSpecification
publicNetworkAccess	數據處理站是否允許公用網路存取。	“Disabled” “Enabled”
purviewConfiguration	處理站的 Purview 資訊。	PurviewConfiguration
repoConfiguration	處理站的 Git 存放庫資訊。	FactoryRepoConfiguration

EncryptionConfiguration

名稱	描述	值
身分識別	使用者指派的身分識別，用來向客戶的密鑰保存庫進行驗證。如果未提供受控服務識別，則會使用。	CMKIdentityDefinition
keyName	Azure 中金鑰的名稱金鑰保存庫做為客戶管理的密鑰。	需要字串 ()
keyVersion	用於 CMK 的金鑰版本。如果未提供，則會使用最新版本。	字串
vaultBaseUrl	用於 CMK 的 Azure 金鑰保存庫 URL。	需要字串 ()

CMKIdentityDefinition

名稱	描述	值
userAssignedIdentity	要向客戶金鑰保存庫進行驗證之使用者指派身分識別的資源識別碼。	字串

GlobalParameterDefinitionSpecification

名稱	描述	值
{自定義屬性}		GlobalParameterSpecification

GlobalParameterSpecification

名稱	描述	值
類型	全域參數類型。	“Array” “Bool” “Float” “Int” “Object” “String” (必要)
值	參數的值。

PurviewConfiguration

名稱	描述	值
purviewResourceId	Purview 資源標識碼。	字串

FactoryRepoConfiguration

名稱	描述	值
accountName	帳戶名稱。	需要字串 ()
collaborationBranch	共同作業分支。	需要字串 ()
disablePublish	停用 ADF Studio 中的手動發佈作業，以偏好自動發佈。	bool
lastCommitId	上次認可標識碼。	字串
repositoryName	存放庫名稱。	需要字串 ()
rootFolder	根資料夾。	需要字串 ()
類型	設定物件類型	FactoryGitHubConfiguration FactoryVSTSConfiguration (必要)

FactoryGitHubConfiguration

名稱	描述	值
類型	存放庫組態的類型。	“FactoryGitHubConfiguration” (必要)
clientId	GitHub 自備應用程式用戶端標識碼。	字串
clientSecret	GitHub 攜帶您自己的應用程式客戶端密碼資訊。	GitHubClientSecret
hostName	GitHub Enterprise 主機名。例如：`https://github.mydomain.com`	字串

GitHubClientSecret

名稱	描述	值
byoaSecretAkvUrl	攜帶您自己的應用程式客戶端密碼 AKV URL。	字串
byoaSecretName	在 AKV 中攜帶您自己的應用程式用戶端密碼名稱。	字串

FactoryVstsConfiguration

名稱	描述	值
類型	存放庫組態的類型。	“FactoryVSTSConfiguration” (必要)
projectName	VSTS 項目名稱。	需要字串 ()
tenantId	VSTS 租使用者標識碼。	字串

共用方式為

Microsoft.DataFactory Factory

Bicep 資源定義

資源格式

FactoryRepoConfiguration 物件

屬性值

factories

FactoryIdentity

UserAssignedIdentitiesDefinitionSpecification

FactoryProperties

EncryptionConfiguration

CMKIdentityDefinition

GlobalParameterDefinitionSpecification

GlobalParameterSpecification

PurviewConfiguration

FactoryRepoConfiguration

FactoryGitHubConfiguration

GitHubClientSecret

FactoryVstsConfiguration

快速入門範本

ARM 範本資源定義

資源格式

FactoryRepoConfiguration 物件

屬性值

factories

FactoryIdentity

UserAssignedIdentitiesDefinitionSpecification

FactoryProperties

EncryptionConfiguration

CMKIdentityDefinition

GlobalParameterDefinitionSpecification

GlobalParameterSpecification

PurviewConfiguration

FactoryRepoConfiguration

FactoryGitHubConfiguration

GitHubClientSecret

FactoryVstsConfiguration

快速入門範本

Terraform (AzAPI 提供者) 資源定義

資源格式

FactoryRepoConfiguration 物件

屬性值

factories

FactoryIdentity

UserAssignedIdentitiesDefinitionSpecification

FactoryProperties

EncryptionConfiguration

CMKIdentityDefinition

GlobalParameterDefinitionSpecification

GlobalParameterSpecification

PurviewConfiguration

FactoryRepoConfiguration

FactoryGitHubConfiguration

GitHubClientSecret

FactoryVstsConfiguration

意見反應

其他資源