Partilhar via


Fábricas Microsoft.DataFactory 2018-06-01

Definição de recursos do bíceps

O tipo de recurso factories pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DataFactory/factories, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.DataFactory/factories@2018-06-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    encryption: {
      identity: {
        userAssignedIdentity: 'string'
      }
      keyName: 'string'
      keyVersion: 'string'
      vaultBaseUrl: 'string'
    }
    globalParameters: {
      {customized property}: {
        type: 'string'
        value: any(Azure.Bicep.Types.Concrete.AnyType)
      }
    }
    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
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos FactoryRepoConfiguration

Defina a propriedade type para especificar o tipo de objeto.

Para FactoryGitHubConfiguration , use:

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

Para FactoryVSTSConfiguration , use:

{
  projectName: 'string'
  tenantId: 'string'
  type: 'FactoryVSTSConfiguration'
}

Valores de propriedade

CMKIdentityDefinition

Designação Descrição Valor
userAssignedIdentity A ID do recurso da identidade atribuída ao usuário para autenticar no cofre de chaves do cliente. string

EncryptionConfiguration

Designação Descrição Valor
identidade Identidade atribuída pelo usuário a ser usada para autenticar no cofre de chaves do cliente. Se não for fornecida, a Identidade do Serviço Gerenciado será usada. CMKIdentityDefinition
Nome da chave O nome da chave no Cofre de Chaves do Azure a ser usada como Chave Gerenciada pelo Cliente. string (obrigatório)
keyVersion [en] A versão da chave usada para CMK. Se não for fornecida, será utilizada a versão mais recente. string
vaultBaseUrl A url do Cofre da Chave do Azure usado para CMK. string (obrigatório)

FactoryGitHubConfiguration

Designação Descrição Valor
ID do cliente O GitHub traz seu próprio ID de cliente de aplicativo. string
clientSecret O GitHub traz suas próprias informações secretas do cliente do aplicativo. GitHubClientSecret
Nome do host Nome do host do GitHub Enterprise. Por exemplo: https://github.mydomain.com string
tipo Tipo de configuração de repo. 'FactoryGitHubConfiguration' (obrigatório)

FactoryIdentity

Designação Descrição Valor
tipo O tipo de identidade. 'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities Lista de identidades atribuídas pelo usuário para a fábrica. UserAssignedIdentitiesDefinitionSpecification

Propriedades da Fábrica

Designação Descrição Valor
encriptação Propriedades para habilitar a Chave Gerenciada pelo Cliente para a fábrica. EncryptionConfiguration
globalParameters Lista de parâmetros para fábrica. GlobalParameterDefinitionSpecification
publicNetworkAccess Se o acesso à rede pública é permitido ou não para o data factory. 'Desativado'
'Habilitado'
purviewConfiguration Informações de purview da fábrica. PurviewConfiguration
repoConfiguration Git repo informações da fábrica. FactoryRepoConfiguration

FactoryRepoConfiguration

Designação Descrição Valor
nomedaconta; Nome da conta. string (obrigatório)
colaboraçãoBranch Ramo de colaboração. string (obrigatório)
desabilitarPublicar Desative a operação de publicação manual no estúdio ADF para favorecer a publicação automatizada. Bool
lastCommitId Última confirmação id. string
repositoryName Nome do repositório. string (obrigatório)
rootFolder Pasta raiz. string (obrigatório)
tipo Defina como 'FactoryGitHubConfiguration' para o tipo FactoryGitHubConfiguration. Defina como 'FactoryVSTSConfiguration' para o tipo FactoryVstsConfiguration. 'FactoryGitHubConfiguration'
'FactoryVSTSConfiguration' (obrigatório)

FactoryVstsConfiguration

Designação Descrição Valor
nome_do_projeto Nome do projeto VSTS. string (obrigatório)
inquilinoId ID do locatário VSTS. string
tipo Tipo de configuração de repo. 'FactoryVSTSConfiguration' (obrigatório)

GitHubClientSecret

Designação Descrição Valor
byoaSecretAkvUrl Traga seu próprio URL AKV secreto do cliente de aplicativo. string
byoaSecretName Traga o nome secreto do seu próprio cliente de aplicativo no AKV. string

GlobalParameterDefinitionSpecification

Designação Descrição Valor

GlobalParameterSpecification

Designação Descrição Valor
tipo Tipo de parâmetro global. 'Matriz'
'Bool'
'Flutuar'
'Int'
'Objeto'
'String' (obrigatório)
valor Valor do parâmetro. qualquer (obrigatório)

Microsoft.DataFactory/fábricas

Designação Descrição Valor
identidade Identidade de serviço gerenciado da fábrica. FactoryIdentity
Localização A localização do recurso. string
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 3
Padrão = ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$ (obrigatório)
propriedades Propriedades da fábrica. FactoryProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

PurviewConfiguration

Designação Descrição Valor
purviewResourceId ID do recurso Purview. string

Tags de Recursos

Designação Descrição Valor

UserAssignedIdentitiesDefinitionSpecification

Designação Descrição Valor

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Azure Data Factory com Git e de configuração vnet gerenciada Este modelo cria o Azure Data Factory com configuração Git e rede virtual gerenciada.
Criar um de fábrica de dados V2 Este modelo cria uma fábrica de dados V2 que copia dados de uma pasta em um Armazenamento de Blob do Azure para outra pasta no armazenamento.
Criar uma fábrica de dados vazia Este modelo cria uma fábrica de dados vazia
Implantar o Sports Analytics no Azure Architecture Cria uma conta de armazenamento do Azure com o ADLS Gen 2 habilitado, uma instância do Azure Data Factory com serviços vinculados para a conta de armazenamento (um Banco de Dados SQL do Azure, se implantado) e uma instância do Azure Databricks. A identidade do AAD para o usuário que implanta o modelo e a identidade gerenciada para a instância do ADF receberão a função de Colaborador de Dados de Blob de Armazenamento na conta de armazenamento. Também há opções para implantar uma instância do Cofre da Chave do Azure, um Banco de Dados SQL do Azure e um Hub de Eventos do Azure (para casos de uso de streaming). Quando um Cofre de Chaves do Azure é implantado, a identidade gerenciada do data factory e a identidade do AAD para o usuário que implanta o modelo receberão a função Usuário de Segredos do Cofre de Chaves.
hub FinOps Este modelo cria uma nova instância de hub FinOps, incluindo armazenamento Data Lake e um Data Factory.
mais é possível com o Azure Data Factory - Um clique para experimentar o Azure Data Factory Este modelo cria um pipeline de fábrica de dados para uma atividade de cópia do Blob do Azure para outro Blob do Azure

Definição de recurso de modelo ARM

O tipo de recurso factories pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DataFactory/factories, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.DataFactory/factories",
  "apiVersion": "2018-06-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "location": "string",
  "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
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos FactoryRepoConfiguration

Defina a propriedade type para especificar o tipo de objeto.

Para FactoryGitHubConfiguration , use:

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

Para FactoryVSTSConfiguration , use:

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

Valores de propriedade

CMKIdentityDefinition

Designação Descrição Valor
userAssignedIdentity A ID do recurso da identidade atribuída ao usuário para autenticar no cofre de chaves do cliente. string

EncryptionConfiguration

Designação Descrição Valor
identidade Identidade atribuída pelo usuário a ser usada para autenticar no cofre de chaves do cliente. Se não for fornecida, a Identidade do Serviço Gerenciado será usada. CMKIdentityDefinition
Nome da chave O nome da chave no Cofre de Chaves do Azure a ser usada como Chave Gerenciada pelo Cliente. string (obrigatório)
keyVersion [en] A versão da chave usada para CMK. Se não for fornecida, será utilizada a versão mais recente. string
vaultBaseUrl A url do Cofre da Chave do Azure usado para CMK. string (obrigatório)

FactoryGitHubConfiguration

Designação Descrição Valor
ID do cliente O GitHub traz seu próprio ID de cliente de aplicativo. string
clientSecret O GitHub traz suas próprias informações secretas do cliente do aplicativo. GitHubClientSecret
Nome do host Nome do host do GitHub Enterprise. Por exemplo: https://github.mydomain.com string
tipo Tipo de configuração de repo. 'FactoryGitHubConfiguration' (obrigatório)

FactoryIdentity

Designação Descrição Valor
tipo O tipo de identidade. 'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities Lista de identidades atribuídas pelo usuário para a fábrica. UserAssignedIdentitiesDefinitionSpecification

Propriedades da Fábrica

Designação Descrição Valor
encriptação Propriedades para habilitar a Chave Gerenciada pelo Cliente para a fábrica. EncryptionConfiguration
globalParameters Lista de parâmetros para fábrica. GlobalParameterDefinitionSpecification
publicNetworkAccess Se o acesso à rede pública é permitido ou não para o data factory. 'Desativado'
'Habilitado'
purviewConfiguration Informações de purview da fábrica. PurviewConfiguration
repoConfiguration Git repo informações da fábrica. FactoryRepoConfiguration

FactoryRepoConfiguration

Designação Descrição Valor
nomedaconta; Nome da conta. string (obrigatório)
colaboraçãoBranch Ramo de colaboração. string (obrigatório)
desabilitarPublicar Desative a operação de publicação manual no estúdio ADF para favorecer a publicação automatizada. Bool
lastCommitId Última confirmação id. string
repositoryName Nome do repositório. string (obrigatório)
rootFolder Pasta raiz. string (obrigatório)
tipo Defina como 'FactoryGitHubConfiguration' para o tipo FactoryGitHubConfiguration. Defina como 'FactoryVSTSConfiguration' para o tipo FactoryVstsConfiguration. 'FactoryGitHubConfiguration'
'FactoryVSTSConfiguration' (obrigatório)

FactoryVstsConfiguration

Designação Descrição Valor
nome_do_projeto Nome do projeto VSTS. string (obrigatório)
inquilinoId ID do locatário VSTS. string
tipo Tipo de configuração de repo. 'FactoryVSTSConfiguration' (obrigatório)

GitHubClientSecret

Designação Descrição Valor
byoaSecretAkvUrl Traga seu próprio URL AKV secreto do cliente de aplicativo. string
byoaSecretName Traga o nome secreto do seu próprio cliente de aplicativo no AKV. string

GlobalParameterDefinitionSpecification

Designação Descrição Valor

GlobalParameterSpecification

Designação Descrição Valor
tipo Tipo de parâmetro global. 'Matriz'
'Bool'
'Flutuar'
'Int'
'Objeto'
'String' (obrigatório)
valor Valor do parâmetro. qualquer (obrigatório)

Microsoft.DataFactory/fábricas

Designação Descrição Valor
apiVersion A versão api '2018-06-01'
identidade Identidade de serviço gerenciado da fábrica. FactoryIdentity
Localização A localização do recurso. string
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 3
Padrão = ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$ (obrigatório)
propriedades Propriedades da fábrica. FactoryProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.DataFactory/fábricas'

PurviewConfiguration

Designação Descrição Valor
purviewResourceId ID do recurso Purview. string

Tags de Recursos

Designação Descrição Valor

UserAssignedIdentitiesDefinitionSpecification

Designação Descrição Valor

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Azure Data Factory com Git e de configuração vnet gerenciada

Implantar no Azure
Este modelo cria o Azure Data Factory com configuração Git e rede virtual gerenciada.
Cópia em massa usando o Azure Data Factory

Implantar no Azure
Este modelo cria uma fábrica de dados V2 que copia dados em massa de um banco de dados SQL do Azure para um data warehouse SQL do Azure.
Criar um Data Factory, copie do Salesforce para o Blob

Implantar no Azure
Este modelo usa o Azure Data Factory para executar a movimentação de dados do Salesforce para os Blobs do Azure
Criar um de fábrica de dados V2

Implantar no Azure
Este modelo cria uma fábrica de dados V2 que copia dados de uma pasta em um Armazenamento de Blob do Azure para outra pasta no armazenamento.
Criar uma fábrica de dados V2 (MySQL)

Implantar no Azure
Este modelo cria uma fábrica de dados V2 que copia dados de uma pasta em um Armazenamento de Blob do Azure para uma tabela em um Banco de Dados do Azure para MySQL.
Criar um de fábrica de dados V2 (PostGre)

Implantar no Azure
Este modelo cria uma fábrica de dados V2 que copia dados de uma pasta em um Armazenamento de Blobs do Azure para uma tabela em um Banco de Dados do Azure para PostgreSQL.
Criar um de fábrica de dados V2 (Spark)

Implantar no Azure
Este modelo cria uma fábrica de dados V2 que copia dados de uma pasta em um Armazenamento de Blob do Azure para outra pasta no armazenamento.
Criar uma fábrica de dados V2 (SQL On-prem)

Implantar no Azure
Este modelo cria uma fábrica de dados V2 que copia dados de um SQL Server local para um armazenamento de blob do Azure
Criar um de fábrica de dados V2 (SQL)

Implantar no Azure
Este modelo cria uma fábrica de dados V2 que copia dados de uma pasta em um Armazenamento de Blob do Azure para uma tabela em um banco de dados SQL do Azure.
Criar uma fábrica de dados vazia

Implantar no Azure
Este modelo cria uma fábrica de dados vazia
Implantar o Sports Analytics no Azure Architecture

Implantar no Azure
Cria uma conta de armazenamento do Azure com o ADLS Gen 2 habilitado, uma instância do Azure Data Factory com serviços vinculados para a conta de armazenamento (um Banco de Dados SQL do Azure, se implantado) e uma instância do Azure Databricks. A identidade do AAD para o usuário que implanta o modelo e a identidade gerenciada para a instância do ADF receberão a função de Colaborador de Dados de Blob de Armazenamento na conta de armazenamento. Também há opções para implantar uma instância do Cofre da Chave do Azure, um Banco de Dados SQL do Azure e um Hub de Eventos do Azure (para casos de uso de streaming). Quando um Cofre de Chaves do Azure é implantado, a identidade gerenciada do data factory e a identidade do AAD para o usuário que implanta o modelo receberão a função Usuário de Segredos do Cofre de Chaves.
hub FinOps

Implantar no Azure
Este modelo cria uma nova instância de hub FinOps, incluindo armazenamento Data Lake e um Data Factory.
mais é possível com o Azure Data Factory - Um clique para experimentar o Azure Data Factory

Implantar no Azure
Este modelo cria um pipeline de fábrica de dados para uma atividade de cópia do Blob do Azure para outro Blob do Azure
Provisionar o tempo de execução do SSIS no Azure

Implantar no Azure
Este modelo cria uma fábrica de dados V2 e, em seguida, provisiona um tempo de execução de integração do SSIS do Azure

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso factories pode ser implantado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DataFactory/factories, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DataFactory/factories@2018-06-01"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = ?
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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
      }
    }
  })
}

Objetos FactoryRepoConfiguration

Defina a propriedade type para especificar o tipo de objeto.

Para FactoryGitHubConfiguration , use:

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

Para FactoryVSTSConfiguration , use:

{
  projectName = "string"
  tenantId = "string"
  type = "FactoryVSTSConfiguration"
}

Valores de propriedade

CMKIdentityDefinition

Designação Descrição Valor
userAssignedIdentity A ID do recurso da identidade atribuída ao usuário para autenticar no cofre de chaves do cliente. string

EncryptionConfiguration

Designação Descrição Valor
identidade Identidade atribuída pelo usuário a ser usada para autenticar no cofre de chaves do cliente. Se não for fornecida, a Identidade do Serviço Gerenciado será usada. CMKIdentityDefinition
Nome da chave O nome da chave no Cofre de Chaves do Azure a ser usada como Chave Gerenciada pelo Cliente. string (obrigatório)
keyVersion [en] A versão da chave usada para CMK. Se não for fornecida, será utilizada a versão mais recente. string
vaultBaseUrl A url do Cofre da Chave do Azure usado para CMK. string (obrigatório)

FactoryGitHubConfiguration

Designação Descrição Valor
ID do cliente O GitHub traz seu próprio ID de cliente de aplicativo. string
clientSecret O GitHub traz suas próprias informações secretas do cliente do aplicativo. GitHubClientSecret
Nome do host Nome do host do GitHub Enterprise. Por exemplo: https://github.mydomain.com string
tipo Tipo de configuração de repo. 'FactoryGitHubConfiguration' (obrigatório)

FactoryIdentity

Designação Descrição Valor
tipo O tipo de identidade. 'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities Lista de identidades atribuídas pelo usuário para a fábrica. UserAssignedIdentitiesDefinitionSpecification

Propriedades da Fábrica

Designação Descrição Valor
encriptação Propriedades para habilitar a Chave Gerenciada pelo Cliente para a fábrica. EncryptionConfiguration
globalParameters Lista de parâmetros para fábrica. GlobalParameterDefinitionSpecification
publicNetworkAccess Se o acesso à rede pública é permitido ou não para o data factory. 'Desativado'
'Habilitado'
purviewConfiguration Informações de purview da fábrica. PurviewConfiguration
repoConfiguration Git repo informações da fábrica. FactoryRepoConfiguration

FactoryRepoConfiguration

Designação Descrição Valor
nomedaconta; Nome da conta. string (obrigatório)
colaboraçãoBranch Ramo de colaboração. string (obrigatório)
desabilitarPublicar Desative a operação de publicação manual no estúdio ADF para favorecer a publicação automatizada. Bool
lastCommitId Última confirmação id. string
repositoryName Nome do repositório. string (obrigatório)
rootFolder Pasta raiz. string (obrigatório)
tipo Defina como 'FactoryGitHubConfiguration' para o tipo FactoryGitHubConfiguration. Defina como 'FactoryVSTSConfiguration' para o tipo FactoryVstsConfiguration. 'FactoryGitHubConfiguration'
'FactoryVSTSConfiguration' (obrigatório)

FactoryVstsConfiguration

Designação Descrição Valor
nome_do_projeto Nome do projeto VSTS. string (obrigatório)
inquilinoId ID do locatário VSTS. string
tipo Tipo de configuração de repo. 'FactoryVSTSConfiguration' (obrigatório)

GitHubClientSecret

Designação Descrição Valor
byoaSecretAkvUrl Traga seu próprio URL AKV secreto do cliente de aplicativo. string
byoaSecretName Traga o nome secreto do seu próprio cliente de aplicativo no AKV. string

GlobalParameterDefinitionSpecification

Designação Descrição Valor

GlobalParameterSpecification

Designação Descrição Valor
tipo Tipo de parâmetro global. 'Matriz'
'Bool'
'Flutuar'
'Int'
'Objeto'
'String' (obrigatório)
valor Valor do parâmetro. qualquer (obrigatório)

Microsoft.DataFactory/fábricas

Designação Descrição Valor
identidade Identidade de serviço gerenciado da fábrica. FactoryIdentity
Localização A localização do recurso. string
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 3
Comprimento máximo = 3
Padrão = ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$ (obrigatório)
propriedades Propriedades da fábrica. FactoryProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.DataFactory/factories@2018-06-01"

PurviewConfiguration

Designação Descrição Valor
purviewResourceId ID do recurso Purview. string

Tags de Recursos

Designação Descrição Valor

UserAssignedIdentitiesDefinitionSpecification

Designação Descrição Valor