Configurer Stockage Table Azure dans l’activité de copie
Cet article explique comment utiliser l’activité de copie dans le pipeline de données pour copier des données depuis et vers Stockage Table Azure.
Configuration prise en charge
Pour la configuration de chaque onglet sous l’activité de copie, accédez respectivement aux sections suivantes.
Général
Reportez-vous aux instructions relatives aux paramètres Général pour configurer l’onglet Paramètres Général .
Source
Accédez à l’onglet Source pour configurer votre source d’activité de copie. Consultez le contenu suivant pour obtenir la configuration détaillée.
Les trois propriétés suivantes sont requises :
Type de magasin de données : sélectionnez Externe.
Connexion : sélectionnez une connexion Stockage Table Azure dans la liste des connexions. Si aucune connexion n’existe, créez une connexion Stockage Table Azure en sélectionnant Nouveau.
Utiliser une requête : spécifiez le mode de lecture des données. Sélectionnez Table pour lire les données à partir de la table spécifiée ou sélectionnez Requête pour lire les données à l’aide de requêtes.
Si vous sélectionnez Table :
- Table : spécifiez le nom de la table dans l’instance de base de données Stockage Table Azure. Sélectionnez la table dans la liste déroulante ou entrez le nom manuellement en sélectionnant Modifier.
Si vous sélectionnez Requête :
Table : spécifiez le nom de la table dans l’instance de base de données Stockage Table Azure. Sélectionnez la table dans la liste déroulante ou entrez le nom manuellement en sélectionnant Modifier.
Requête : spécifiez la requête de stockage Table personnalisée pour lire les données. La requête source est une carte directe de l’option de requête
$filterprise en charge par Stockage Table Azure. Pour en savoir plus sur la syntaxe, consultez cet article.Remarque
L’opération de requête Table Azure expire dans 30 secondes, conformément au service de Table Azure. Découvrez comment optimiser la requête dans l’article Conception pour l’interrogation.
Sous Avancé, vous pouvez spécifier les champs suivants :
Ignorer table introuvable : indique s’il faut autoriser l’exception de la table qui n’existe pas. L’option est non sélectionnée par défaut.
Colonnes supplémentaires : ajoutez des colonnes de données supplémentaires au chemin d’accès relatif ou à la valeur statique des fichiers sources du magasin. L'expression est prise en charge pour ce dernier.
Destination
Accédez à l’onglet Destination pour configurer la destination de votre activité de copie. Consultez le contenu suivant pour obtenir la configuration détaillée.
Les trois propriétés suivantes sont requises :
- Type de magasin de données : sélectionnez Externe.
- Connexion : sélectionnez une connexion Stockage Table Azure dans la liste des connexions. Si aucune connexion n’existe, créez une connexion Stockage Table Azure en sélectionnant Nouveau.
- Table : spécifiez le nom de la table dans l’instance de base de données Stockage Table Azure. Sélectionnez la table dans la liste déroulante ou entrez le nom manuellement en sélectionnant Modifier.
Sous Avancé, vous pouvez spécifier les champs suivants :
Type d’insertion : sélectionnez le mode d’insertion des données dans Table Azure. Les modes sont Fusionner et Remplacer. Cette propriété détermine le remplacement ou la fusion des valeurs des lignes existantes dans la table de sortie avec des clés de partition et de ligne correspondantes. Ce paramètre s’applique au niveau ligne et non au niveau table. Ces options ne suppriment pas de lignes dans la table de sortie qui n’existent pas dans l’entrée. Consultez Insert Or Merge Entity (Entité d’insertion ou de fusion) et Insert Or Replace Entity (Entité d’insertion ou de remplacement) pour en savoir plus sur le fonctionnement des paramètres fusionner et remplacer.
Sélection de la valeur de clé de partition : sélectionnez Spécifier la valeur de partition ou Utiliser une colonne de destination. La valeur de clé de partition peut être une valeur fixe ou prendre une valeur d’une colonne de destination.
Si vous sélectionnez Spécifier la valeur de partition :
- Valeur de partition par défaut : spécifiez la valeur de clé de partition par défaut qui peut être utilisée par la destination.
Si vous sélectionnez Utiliser une colonne de destination :
- Colonne de clé de partition : sélectionnez le nom de la colonne dont les valeurs sont utilisées comme clé de partition. Si aucune valeur n'est spécifiée, « AzureTableDefaultPartitionKeyValue » est utilisée comme clé de partition.
Sélection de la valeur de clé de ligne : sélectionnez Identificateur unique ou Utiliser une colonne de destination. La valeur de clé de ligne peut être un identificateur unique généré automatiquement ou prendre une valeur d’une colonne de destination.
Si vous sélectionnez Utiliser une colonne de destination :
- Colonne de clé de ligne : sélectionnez le nom de la colonne dont les valeurs sont utilisées comme clé de ligne. Si aucune valeur n'est spécifiée, un GUID est utilisé pour chaque ligne.
Taille de lot d’écriture : insère des données dans la Table Azure lorsque la taille de lot d’écriture spécifiée est atteinte. Les valeurs autorisées sont des nombre entiers (nombre de lignes). La valeur par défaut est 10 000.
Délai d’expiration de lot d’écriture : insère des données dans la Table Azure lorsque le délai d’expiration de lot d’écriture spécifiée est atteint. La valeur autorisée est timespan.
Nombre maximal de connexions simultanées : la limite supérieure de connexions simultanées établies au magasin de données pendant l’exécution de l’activité. Spécifiez une valeur seulement si vous voulez limiter les connexions simultanées
Mappage
Pour la configuration de l’onglet Mappage, consultez Configurer vos mappages sous l’onglet Mappage.
Paramètres
Pour la configuration de l’onglet Paramètres, accédez à Configurer vos autres paramètres sous l’onglet Paramètres.
Résumé du tableau
Le tableau suivant contient plus d’informations sur l’activité de copie dans Stockage Table Azure.
Informations sur la source
| Nom | Description | Valeur | Obligatoire | Propriété de script JSON |
|---|---|---|---|---|
| Type de banque de données | Votre type de magasin de données. | Externe | Oui | / |
| Connection | Votre connexion au magasin de données source. | < votre connexion Stockage Table Azure > | Oui | connection |
| Utiliser la requête | La façon de lire des données. Appliquez Table pour lire les données à partir de la table spécifiée ou appliquez Requête pour lire les données à l’aide de requêtes. | Table • Requête |
Oui | / |
| Table | Nom de la table dans l’instance de base de données Stockage Table Azure. | < nom de votre table > | Oui | tableName |
| Requête | Spécifiez la requête de stockage Table personnalisée pour lire les données. La requête source est une carte directe de l’option de requête $filter prise en charge par Stockage Table Azure. Pour en savoir plus sur la syntaxe, consultez cet article. |
< votre requête > | Non | AzureTableSourceQuery |
| Ignorer table introuvable | Indique s’il faut autoriser l’exception de la table qui n’existe pas. | sélectionné ou non sélectionné (par défaut) | Non | azureTableSourceIgnoreTableNotFound: true ou false (par défaut) |
| Colonnes supplémentaires | Ajouter les colonnes de données supplémentaires pour stocker le chemin d’accès relatif ou la valeur statique des fichiers sources. L’expression est prise en charge pour ce dernier. | • Name • Valeur |
Non | additionalColumns : • nom • valeur |
Informations de destination
| Nom | Description | Valeur | Obligatoire | Propriété de script JSON |
|---|---|---|---|---|
| Type de banque de données | Votre type de magasin de données. | Externe | Oui | / |
| Connection | Votre connexion au magasin de données de destination. | < votre connexion Stockage Table Azure > | Oui | connection |
| Table | Nom de la table dans l’instance de base de données Stockage Table Azure. | < nom de votre table > | Oui | tableName |
| Type d’insertion | Le mode d’insertion des données dans Table Azure. Cette propriété détermine le remplacement ou la fusion des valeurs des lignes existantes dans la table de sortie avec des clés de partition et de ligne correspondantes. | • Fusionner • Remplacer |
Non | azureTableInsertType : • fusionner • remplacer |
| Sélection de la valeur de clé de partition | La valeur de clé de partition peut être une valeur fixe ou prendre une valeur d’une colonne de destination. | • Spécifier la valeur de partition • Utiliser une colonne de destination |
Non | / |
| Valeur de partition par défaut | Valeur de clé de partition par défaut qui peut être utilisée par la destination | < votre valeur de partition par défaut > | Non | azureTableDefaultPartitionKeyValue |
| Colonne de clé de partition | Nom de la colonne dont les valeurs sont utilisées comme clés de partition. Si aucune valeur n'est spécifiée, « AzureTableDefaultPartitionKeyValue » est utilisée comme clé de partition. | < votre colonne de clé de partition > | Non | azureTablePartitionKeyName |
| Sélection de la valeur de clé de ligne | La valeur de clé de ligne peut être un identificateur unique généré automatiquement ou prendre une valeur d’une colonne de destination. | • Identificateur unique • Utiliser une colonne de destination |
Non | / |
| Colonne de clé de ligne | Nom de la colonne dont les valeurs sont utilisées comme clé de ligne. Si aucune valeur n'est spécifiée, un GUID est utilisé pour chaque ligne. | < votre colonne de clé de ligne > | Non | azureTableRowKeyName |
| Taille de lot d’écriture | Insère des données dans la Table Azure lorsque la taille de lot d’écriture est atteinte. | entier (Valeur par défaut : 10 000) |
Non | writeBatchSize |
| Délai d’expiration du lot d’écriture | Insère des données dans la Table Azure lorsque le délai d’expiration de lot d’écriture est atteint | intervalle de temps | Non | writeBatchTimeout |
| Connexions simultanées maximales | La limite supérieure de connexions simultanées établies au magasin de données pendant l’exécution de l’activité. Spécifiez une valeur uniquement lorsque vous souhaitez limiter les connexions simultanées. | < nombre maximal de vos connexions simultanées > | Non | maxConcurrentConnections |