Partager via


Fabriques Microsoft.DataFactory

Définition de ressource Bicep

Le type de ressource des fabriques peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DataFactory/factories, ajoutez le bicep suivant à votre modèle.

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

Objets FactoryRepoConfiguration

Définissez le type propriété pour spécifier le type d’objet.

Pour factoryGitHubConfiguration, utilisez :

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

Pour FactoryVSTSConfiguration, utilisez :

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

Valeurs de propriété

CMKIdentityDefinition

Nom Description Valeur
userAssignedIdentity ID de ressource de l’identité affectée par l’utilisateur pour s’authentifier auprès du coffre de clés du client. corde

EncryptionConfiguration

Nom Description Valeur
identité Identité affectée par l’utilisateur à utiliser pour s’authentifier auprès du coffre de clés du client. Si aucune identité de service managée n’est fournie, elle est utilisée. CMKIdentityDefinition
keyName Nom de la clé dans Azure Key Vault à utiliser comme clé gérée par le client. chaîne (obligatoire)
keyVersion Version de la clé utilisée pour CMK. S’il n’est pas fourni, la dernière version sera utilisée. corde
vaultBaseUrl URL d’Azure Key Vault utilisée pour CMK. chaîne (obligatoire)

FactoryGitHubConfiguration

Nom Description Valeur
clientId GitHub apporte votre propre ID client d’application. corde
clientSecret GitHub apporte vos propres informations de clé secrète client d’application. gitHubClientSecret
hostName Nom d’hôte GitHub Enterprise. Par exemple : https://github.mydomain.com corde
type Type de configuration du dépôt. 'FactoryGitHubConfiguration' (obligatoire)

FactoryIdentity

Nom Description Valeur
type Type d’identité. 'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Liste des identités affectées par l’utilisateur pour la fabrique. UserAssignedIdentitiesDefinitionSpecification

FactoryProperties

Nom Description Valeur
chiffrement Propriétés permettant d’activer la clé gérée par le client pour la fabrique. EncryptionConfiguration
globalParameters Liste des paramètres pour la fabrique. GlobalParameterDefinitionSpecification
publicNetworkAccess Indique si l’accès au réseau public est autorisé pour la fabrique de données. 'Désactivé'
'Activé'
purviewConfiguration Informations Purview de la fabrique. PurviewConfiguration
repoConfiguration Informations sur le dépôt Git de la fabrique. factoryRepoConfiguration

FactoryRepoConfiguration

Nom Description Valeur
accountName Nom du compte. chaîne (obligatoire)
CollaborationBranch Branche de collaboration. chaîne (obligatoire)
disablePublish Désactivez l’opération de publication manuelle dans ADF Studio pour favoriser la publication automatisée. Bool
lastCommitId Dernier ID de validation. corde
repositoryName Nom du référentiel. chaîne (obligatoire)
rootFolder Dossier racine. chaîne (obligatoire)
type Défini sur « FactoryGitHubConfiguration » pour le type FactoryGitHubConfiguration. Défini sur « FactoryVSTSConfiguration » pour le type FactoryVstsConfiguration. 'FactoryGitHubConfiguration'
'FactoryVSTSConfiguration' (obligatoire)

FactoryVstsConfiguration

Nom Description Valeur
projectName Nom du projet VSTS. chaîne (obligatoire)
tenantId ID de locataire VSTS. corde
type Type de configuration du dépôt. 'FactoryVSTSConfiguration' (obligatoire)

GitHubClientSecret

Nom Description Valeur
byoaSecretAkvUrl Apportez votre propre URL AKV de secret client d’application. corde
byoaSecretName Apportez votre propre nom de clé secrète client d’application dans AKV. corde

GlobalParameterDefinitionSpecification

Nom Description Valeur

GlobalParameterSpecification

Nom Description Valeur
type Type de paramètre global. 'Array'
'Bool'
'Float'
'Int'
'Object'
'String' (obligatoire)
valeur Valeur du paramètre. tout (obligatoire)

Microsoft.DataFactory/factories

Nom Description Valeur
identité Identité du service managé de la fabrique. FactoryIdentity
emplacement Emplacement de la ressource. corde
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 3
Longueur maximale = 3
Modèle = ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$ (obligatoire)
Propriétés Propriétés de la fabrique. FactoryProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

PurviewConfiguration

Nom Description Valeur
purviewResourceId ID de ressource Purview. corde

ResourceTags

Nom Description Valeur

UserAssignedIdentitiesDefinitionSpecification

Nom Description Valeur

Exemples de démarrage rapide

Les exemples de démarrage rapide suivants déploient ce type de ressource.

Fichier Bicep Description
Azure Data Factory avec git et la configuration de réseau virtuel managé Ce modèle crée Azure Data Factory avec la configuration Git et le réseau virtuel managé.
Créer une fabrique de données V2 Ce modèle crée une fabrique de données V2 qui copie les données d’un dossier d’un stockage Blob Azure vers un autre dossier du stockage.
Créer une fabrique de données vide Ce modèle crée une fabrique de données vide
Déployer sports Analytics sur l’architecture Azure Crée un compte de stockage Azure avec ADLS Gen2 activé, une instance Azure Data Factory avec des services liés pour le compte de stockage (une base de données Azure SQL si déployée) et une instance Azure Databricks. L’identité AAD pour l’utilisateur qui déploie le modèle et l’identité managée pour l’instance ADF reçoivent le rôle Contributeur aux données blob de stockage sur le compte de stockage. Il existe également des options pour déployer une instance Azure Key Vault, une base de données Azure SQL et un Hub d’événements Azure (pour les cas d’utilisation de streaming). Lorsqu’un coffre de clés Azure est déployé, l’identité managée de la fabrique de données et l’identité AAD pour l’utilisateur qui déploie le modèle reçoivent le rôle Utilisateur des secrets Key Vault.
hub FinOps Ce modèle crée une instance de hub FinOps, notamment Data Lake Storage et Data Factory.
Plus est possible avec Azure Data Factory - Un clic pour essayer Azure Data Factory Ce modèle crée un pipeline de fabrique de données pour une activité de copie à partir d’un objet blob Azure vers un autre objet blob Azure

Définition de ressource de modèle ARM

Le type de ressource des fabriques peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DataFactory/factories, ajoutez le code JSON suivant à votre modèle.

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

Objets FactoryRepoConfiguration

Définissez le type propriété pour spécifier le type d’objet.

Pour factoryGitHubConfiguration, utilisez :

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

Pour FactoryVSTSConfiguration, utilisez :

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

Valeurs de propriété

CMKIdentityDefinition

Nom Description Valeur
userAssignedIdentity ID de ressource de l’identité affectée par l’utilisateur pour s’authentifier auprès du coffre de clés du client. corde

EncryptionConfiguration

Nom Description Valeur
identité Identité affectée par l’utilisateur à utiliser pour s’authentifier auprès du coffre de clés du client. Si aucune identité de service managée n’est fournie, elle est utilisée. CMKIdentityDefinition
keyName Nom de la clé dans Azure Key Vault à utiliser comme clé gérée par le client. chaîne (obligatoire)
keyVersion Version de la clé utilisée pour CMK. S’il n’est pas fourni, la dernière version sera utilisée. corde
vaultBaseUrl URL d’Azure Key Vault utilisée pour CMK. chaîne (obligatoire)

FactoryGitHubConfiguration

Nom Description Valeur
clientId GitHub apporte votre propre ID client d’application. corde
clientSecret GitHub apporte vos propres informations de clé secrète client d’application. gitHubClientSecret
hostName Nom d’hôte GitHub Enterprise. Par exemple : https://github.mydomain.com corde
type Type de configuration du dépôt. 'FactoryGitHubConfiguration' (obligatoire)

FactoryIdentity

Nom Description Valeur
type Type d’identité. 'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Liste des identités affectées par l’utilisateur pour la fabrique. UserAssignedIdentitiesDefinitionSpecification

FactoryProperties

Nom Description Valeur
chiffrement Propriétés permettant d’activer la clé gérée par le client pour la fabrique. EncryptionConfiguration
globalParameters Liste des paramètres pour la fabrique. GlobalParameterDefinitionSpecification
publicNetworkAccess Indique si l’accès au réseau public est autorisé pour la fabrique de données. 'Désactivé'
'Activé'
purviewConfiguration Informations Purview de la fabrique. PurviewConfiguration
repoConfiguration Informations sur le dépôt Git de la fabrique. factoryRepoConfiguration

FactoryRepoConfiguration

Nom Description Valeur
accountName Nom du compte. chaîne (obligatoire)
CollaborationBranch Branche de collaboration. chaîne (obligatoire)
disablePublish Désactivez l’opération de publication manuelle dans ADF Studio pour favoriser la publication automatisée. Bool
lastCommitId Dernier ID de validation. corde
repositoryName Nom du référentiel. chaîne (obligatoire)
rootFolder Dossier racine. chaîne (obligatoire)
type Défini sur « FactoryGitHubConfiguration » pour le type FactoryGitHubConfiguration. Défini sur « FactoryVSTSConfiguration » pour le type FactoryVstsConfiguration. 'FactoryGitHubConfiguration'
'FactoryVSTSConfiguration' (obligatoire)

FactoryVstsConfiguration

Nom Description Valeur
projectName Nom du projet VSTS. chaîne (obligatoire)
tenantId ID de locataire VSTS. corde
type Type de configuration du dépôt. 'FactoryVSTSConfiguration' (obligatoire)

GitHubClientSecret

Nom Description Valeur
byoaSecretAkvUrl Apportez votre propre URL AKV de secret client d’application. corde
byoaSecretName Apportez votre propre nom de clé secrète client d’application dans AKV. corde

GlobalParameterDefinitionSpecification

Nom Description Valeur

GlobalParameterSpecification

Nom Description Valeur
type Type de paramètre global. 'Array'
'Bool'
'Float'
'Int'
'Object'
'String' (obligatoire)
valeur Valeur du paramètre. tout (obligatoire)

Microsoft.DataFactory/factories

Nom Description Valeur
apiVersion Version de l’API '2018-06-01'
identité Identité du service managé de la fabrique. FactoryIdentity
emplacement Emplacement de la ressource. corde
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 3
Longueur maximale = 3
Modèle = ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$ (obligatoire)
Propriétés Propriétés de la fabrique. FactoryProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.DataFactory/factories'

PurviewConfiguration

Nom Description Valeur
purviewResourceId ID de ressource Purview. corde

ResourceTags

Nom Description Valeur

UserAssignedIdentitiesDefinitionSpecification

Nom Description Valeur

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Azure Data Factory avec git et la configuration de réseau virtuel managé

Déployer sur Azure
Ce modèle crée Azure Data Factory avec la configuration Git et le réseau virtuel managé.
copie en bloc à l’aide d’Azure Data Factory

Déployer sur Azure
Ce modèle crée une fabrique de données V2 qui copie des données en bloc dans une base de données Azure SQL vers un entrepôt de données Azure SQL.
Créer une fabrique de données, copier à partir de Salesforce vers le Blob

Déployer sur Azure
Ce modèle utilise Azure Data Factory pour effectuer le déplacement des données de Salesforce vers des objets blob Azure
Créer une fabrique de données V2

Déployer sur Azure
Ce modèle crée une fabrique de données V2 qui copie les données d’un dossier d’un stockage Blob Azure vers un autre dossier du stockage.
Créer une fabrique de données V2 (MySQL)

Déployer sur Azure
Ce modèle crée une fabrique de données V2 qui copie les données d’un dossier d’un stockage Blob Azure vers une table d’une base de données Azure pour MySQL.
Créer une fabrique de données V2 (PostGre)

Déployer sur Azure
Ce modèle crée une fabrique de données V2 qui copie les données d’un dossier d’un stockage Blob Azure vers une table d’une base de données Azure pour PostgreSQL.
Créer une fabrique de données V2 (Spark)

Déployer sur Azure
Ce modèle crée une fabrique de données V2 qui copie les données d’un dossier d’un stockage Blob Azure vers un autre dossier du stockage.
Créer une fabrique de données V2 (SQL local)

Déployer sur Azure
Ce modèle crée une fabrique de données V2 qui copie les données d’un serveur SQL Server local vers un stockage Blob Azure
Créer une fabrique de données V2 (SQL)

Déployer sur Azure
Ce modèle crée une fabrique de données V2 qui copie les données d’un dossier d’un stockage Blob Azure vers une table d’une base de données Azure SQL.
Créer une fabrique de données vide

Déployer sur Azure
Ce modèle crée une fabrique de données vide
Déployer sports Analytics sur l’architecture Azure

Déployer sur Azure
Crée un compte de stockage Azure avec ADLS Gen2 activé, une instance Azure Data Factory avec des services liés pour le compte de stockage (une base de données Azure SQL si déployée) et une instance Azure Databricks. L’identité AAD pour l’utilisateur qui déploie le modèle et l’identité managée pour l’instance ADF reçoivent le rôle Contributeur aux données blob de stockage sur le compte de stockage. Il existe également des options pour déployer une instance Azure Key Vault, une base de données Azure SQL et un Hub d’événements Azure (pour les cas d’utilisation de streaming). Lorsqu’un coffre de clés Azure est déployé, l’identité managée de la fabrique de données et l’identité AAD pour l’utilisateur qui déploie le modèle reçoivent le rôle Utilisateur des secrets Key Vault.
hub FinOps

Déployer sur Azure
Ce modèle crée une instance de hub FinOps, notamment Data Lake Storage et Data Factory.
Plus est possible avec Azure Data Factory - Un clic pour essayer Azure Data Factory

Déployer sur Azure
Ce modèle crée un pipeline de fabrique de données pour une activité de copie à partir d’un objet blob Azure vers un autre objet blob Azure
Provisionner le runtime SSIS dans Azure

Déployer sur Azure
Ce modèle crée une fabrique de données V2, puis provisionne un runtime d’intégration Azure SSIS

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource des fabriques peut être déployé avec des opérations qui ciblent :

  • groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.DataFactory/factories, ajoutez terraform suivant à votre modèle.

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

Objets FactoryRepoConfiguration

Définissez le type propriété pour spécifier le type d’objet.

Pour factoryGitHubConfiguration, utilisez :

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

Pour FactoryVSTSConfiguration, utilisez :

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

Valeurs de propriété

CMKIdentityDefinition

Nom Description Valeur
userAssignedIdentity ID de ressource de l’identité affectée par l’utilisateur pour s’authentifier auprès du coffre de clés du client. corde

EncryptionConfiguration

Nom Description Valeur
identité Identité affectée par l’utilisateur à utiliser pour s’authentifier auprès du coffre de clés du client. Si aucune identité de service managée n’est fournie, elle est utilisée. CMKIdentityDefinition
keyName Nom de la clé dans Azure Key Vault à utiliser comme clé gérée par le client. chaîne (obligatoire)
keyVersion Version de la clé utilisée pour CMK. S’il n’est pas fourni, la dernière version sera utilisée. corde
vaultBaseUrl URL d’Azure Key Vault utilisée pour CMK. chaîne (obligatoire)

FactoryGitHubConfiguration

Nom Description Valeur
clientId GitHub apporte votre propre ID client d’application. corde
clientSecret GitHub apporte vos propres informations de clé secrète client d’application. gitHubClientSecret
hostName Nom d’hôte GitHub Enterprise. Par exemple : https://github.mydomain.com corde
type Type de configuration du dépôt. 'FactoryGitHubConfiguration' (obligatoire)

FactoryIdentity

Nom Description Valeur
type Type d’identité. 'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obligatoire)
userAssignedIdentities Liste des identités affectées par l’utilisateur pour la fabrique. UserAssignedIdentitiesDefinitionSpecification

FactoryProperties

Nom Description Valeur
chiffrement Propriétés permettant d’activer la clé gérée par le client pour la fabrique. EncryptionConfiguration
globalParameters Liste des paramètres pour la fabrique. GlobalParameterDefinitionSpecification
publicNetworkAccess Indique si l’accès au réseau public est autorisé pour la fabrique de données. 'Désactivé'
'Activé'
purviewConfiguration Informations Purview de la fabrique. PurviewConfiguration
repoConfiguration Informations sur le dépôt Git de la fabrique. factoryRepoConfiguration

FactoryRepoConfiguration

Nom Description Valeur
accountName Nom du compte. chaîne (obligatoire)
CollaborationBranch Branche de collaboration. chaîne (obligatoire)
disablePublish Désactivez l’opération de publication manuelle dans ADF Studio pour favoriser la publication automatisée. Bool
lastCommitId Dernier ID de validation. corde
repositoryName Nom du référentiel. chaîne (obligatoire)
rootFolder Dossier racine. chaîne (obligatoire)
type Défini sur « FactoryGitHubConfiguration » pour le type FactoryGitHubConfiguration. Défini sur « FactoryVSTSConfiguration » pour le type FactoryVstsConfiguration. 'FactoryGitHubConfiguration'
'FactoryVSTSConfiguration' (obligatoire)

FactoryVstsConfiguration

Nom Description Valeur
projectName Nom du projet VSTS. chaîne (obligatoire)
tenantId ID de locataire VSTS. corde
type Type de configuration du dépôt. 'FactoryVSTSConfiguration' (obligatoire)

GitHubClientSecret

Nom Description Valeur
byoaSecretAkvUrl Apportez votre propre URL AKV de secret client d’application. corde
byoaSecretName Apportez votre propre nom de clé secrète client d’application dans AKV. corde

GlobalParameterDefinitionSpecification

Nom Description Valeur

GlobalParameterSpecification

Nom Description Valeur
type Type de paramètre global. 'Array'
'Bool'
'Float'
'Int'
'Object'
'String' (obligatoire)
valeur Valeur du paramètre. tout (obligatoire)

Microsoft.DataFactory/factories

Nom Description Valeur
identité Identité du service managé de la fabrique. FactoryIdentity
emplacement Emplacement de la ressource. corde
nom Nom de la ressource corde

Contraintes:
Longueur minimale = 3
Longueur maximale = 3
Modèle = ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$ (obligatoire)
Propriétés Propriétés de la fabrique. FactoryProperties
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.DataFactory/factories@2018-06-01 »

PurviewConfiguration

Nom Description Valeur
purviewResourceId ID de ressource Purview. corde

ResourceTags

Nom Description Valeur

UserAssignedIdentitiesDefinitionSpecification

Nom Description Valeur