L’outil Mettre à jour des champs met à jour le nom ou le type d’un champ.
Exemples
L’outil Mettre à jour des champs peut être utilisé dans les scénarios suivants :
- Un jeu de données comporte des champs portant des noms qui ne donnent pas d’informations sur leur contenu. Mettez à jour les champs pour que leurs noms soient plus pertinents.
- Un champ de code postal a été détecté comme type d’entier alors que le processus implique que les valeurs de code postal soient des chaînes. Mettez à jour le type de champ pour convertir les entiers en chaînes.
- Vous disposez d’un champ de chaîne contenant des géométries au format WKT. Utilisez les champs de mise à jour pour convertir la chaîne en géométrie.
Paramètres
Le tableau suivant décrit les paramètres utilisés dans l’outil Mettre à jour des champs :
| Paramètre | Description |
|---|---|
Jeu de données en entrée | Jeu de données contenant les champs qui seront mis à jour. |
Mises à jour | Un ou plusieurs champs avec les mises à jour qui seront apportées à chacun d’eux. |
Séparateur décimal | Indiquez un séparateur décimal si vous convertissez des valeurs de chaîne en nombres alors que les valeurs de chaîne n’utilisent pas le point (.) comme séparateur décimal. Ce paramètre est facultatif. |
Remarques sur l’utilisation
Utilisez le paramètre Input dataset (Jeu de données en entrée) pour identifier le jeu de données contenant les champs qui seront mis à jour.
Cliquez sur le bouton Configure updates (Configurer les mises à jour) pour lancer la boîte de dialogue modale Update fields (Mettre à jour les champs) dans lequel vous pouvez indiquer les mises à jour de champ.
La boîte de dialogue Update fields (Mettre à jour les champs) offre les possibilités suivantes :
- Vous pouvez mettre à jour le nom du champ, le type ou une combinaison des deux. Au moins une mise à jour est obligatoire pour chaque champ. Les options sont les suivantes :
- Field to update (Champ à mettre à jour) : spécifie le champ à mettre à jour.
- New field name (Nouveau nom de champ) : met à jour le nom du champ spécifié.
- New field type (Nouveau type de champ) : met à jour le type du champ spécifié.
- Le bouton Add field (Ajouter un champ) peut être utilisé pour ajouter des champs individuels à mettre à jour. Pour ajouter tous les champs en une seule fois, utilisez le bouton Add all fields (Ajouter tous les champs).
- Le bouton Add suggested fields (Ajouter les champs suggérés) peut être utilisé pour configurer automatiquement les mises à jour recommandées par Data Pipelines. Si vous cliquez sur ce bouton, Data Pipelines échantillonne les données et peut suggérer des mises à jour. Par exemple, si un champ de chaîne contient des valeurs telles que "12/23/2025", Data Pipelines peut suggérer un nouveau type de champ de date contenant uniquement une date au format MM/dd/yyyy.
Les suggestions sont proposées en fonction d’un échantillon de données. Si un champ contient des valeurs nulles ou vides, il peut ne faire l’objet d’aucune suggestion.
Les options de type de champ disponibles sont les suivantes :
- String (Chaîne) : renvoie un champ de type chaîne en sortie. Les champs de chaîne prennent en charge les chaîne de caractères (texte).
- Float (Flottant) : renvoie un champ à valeur flottante. Les champs de type flottant prennent en charge les nombres fractionnels compris approximativement entre -3,4E38 et 3,4E38.
- Double : renvoie un champ de type réel double en sortie. Les champs de type double prennent en charge les nombres fractionnels compris approximativement entre -2,2E308 et 1,8E308.
- Small integer (Petit entier) : renvoie un champ de type petit entier. Les champs de type entier petit prennent en charge les nombres entiers compris entre -32768 et 32767.
- Integer (Entier) : renvoie un champ de type d’entier en sortie. Les champs de type entier prennent en charge les nombres entiers compris entre -2147483648 et 2147483647.
- Big integer (Entier très grand) : renvoie un champ de type entier très grand. Les champs de type entier très grand prennent en charge les nombres entiers compris entre -9223372036854776000 et 9223372036854776000.
- Date : renvoie un champ de type date. Les champs de date contiennent des valeurs de date et d’heure (12/23/2025 12:30:30 PM, par exemple).
- Date only (Date uniquement) : renvoie un champ de type date uniquement. Les champs de date uniquement contiennent une valeur de date (12/23/2025, par exemple).
- Point : renvoie un champ de géométrie ponctuelle.
- Polyline (Polyligne) : renvoie un champ de géométrie polyligne.
- Polygon (Polygone) : renvoie un champ de géométrie surfacique.
- Multipoint : renvoie un champ de géométrie multi-points.
- Boolean (Booléen) : renvoie un champ de type booléen en sortie. Les champs de type booléen prennent en charge les valeurs true et false.
Si les valeurs ne peuvent pas être converties vers le nouveau type, le résultat sera null et n’apparaîtra pas dans la sortie.
Utilisez le paramètre Decimal separator (Séparateur décimal) pour convertir des champs de chaîne en réel double si les chaînes utilisent des séparateurs décimaux qui ne sont pas des points (.). Ce paramètre est facultatif. Voici quelques exemples d’utilisation du paramètre de séparateur décimal :
- Un champ de chaîne contient des valeurs réelles doubles utilisant la virgule comme séparateur décimal. Exemple : "3,55". Pour convertir ce champ en réel double, spécifiez un nouveau type de champ réel double et utilisez une virgule (,) en guise de séparateur décimal. Il en résulte un champ de réel double contenant des valeurs telles que 3.55.
- Un champ de chaîne contient des valeurs d’entiers avec des zéros de remplissage en trop. Exemple : "5,0000". Pour convertir ce champ en entier, spécifiez un nouveau type de champ entier et utilisez une virgule (,) en guise de séparateur décimal. Il en résulte un champ d’entier contenant des valeurs telles que 5.
En ce qui concerne tous les champs numériques, l’aperçu présente le nombre selon les paramètres régionaux définis dans vos paramètres d’utilisateur.
Comportement du type de conversion
L’outil Update fields (Mettre à jour des champs) gère les conversions de champ de manière différente selon le type en entrée et le type cible. Les conversions prises en charge aboutissent ou renvoient une valeur nulle si la valeur d’origine ne peut pas être convertie vers le type cible. Si la conversion n’est pas prise en charge, le pipeline de données échoue avec une erreur. Le tableau suivant indique si la conversion est prise en charge et précise le format de la valeur convertie le cas échéant :
| Chaîne | Entier petit | Entier | Entier très grand | Flottant | Double | Date uniquement | Date | Booléen | Point | Multi-point | Polyligne | Polygone | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chaîne | Oui | Oui (arrondi) | Oui (arrondi) | Oui (arrondi) | Oui | Oui | Oui | Oui | Oui | Oui5 | Oui5 | Oui5 | Oui5 |
Entier petit | Oui | Oui | Oui | Oui | Oui | Oui | Non | Non | Oui | Non | Non | Non | Non |
Entier | Oui | Oui | Oui | Oui | Oui | Oui | Non | Oui3 | Oui | Non | Non | Non | Non |
Entier très grand | Oui | Oui | Oui | Oui | Oui | Oui | Non | Oui3 | Oui | Non | Non | Non | Non |
Flottant | Oui | Oui (arrondi) | Oui (arrondi) | Oui (arrondi) | Oui | Oui | Non | Oui3 | Oui | Non | Non | Non | Non |
Double | Oui | Oui (arrondi) | Oui (arrondi) | Oui (arrondi) | Oui | Oui | Non | Oui3 | Oui | Non | Non | Non | Non |
Date uniquement | Oui (ISO 8601) | Non | Non | Non | Non | Non | Oui1 | Non | Non | Non | Non | Non | Non |
Date | Oui (ISO 8601) | Non | Oui (secondes) | Non | Non | Oui (secondes) | Oui2 | Oui1 | Non | Non | Non | Non | Non |
Booléen | Oui ("true", "false") | Oui | Oui | Oui | Oui | Oui | Non | Non | Oui | Non | Non | Non | Non |
BLOB | Oui | Non | Non | Non | Non | Non | Non | Non | Non | Oui5 | Oui5 | Oui5 | Oui5 |
Tableau | Oui (JSON) | Non | Non | Non | Non | Non | Non | Non | Non | Non | Non | Non | Non |
Carte | Oui (JSON) | Non | Non | Non | Non | Non | Non | Non | Non | Non | Non | Non | Non |
Struct | Oui (JSON) | Non | Non | Non | Non | Non | Non | Non | Non | Oui5 | Oui5 | Oui5 | Oui5 |
Point | Oui (EsriJSON) | Non | Non | Non | Non | Non | Non | Non | Non | Oui4 | Non | Non | Non |
Multi-point | Oui (EsriJSON) | Non | Non | Non | Non | Non | Non | Non | Non | Non | Oui4 | Non | Non |
Polyligne | Oui (EsriJSON) | Non | Non | Non | Non | Non | Non | Non | Non | Non | Non | Oui4 | Non |
Polygone | Oui (EsriJSON) | Non | Non | Non | Non | Non | Non | Non | Non | Non | Non | Non | Oui4 |
1 Les paramètres Date format (Format de date) et Time zone (Fuseau horaire) sont ignorés.
2 Date format (Format de date) est ignoré. Time zone (Fuseau horaire) est requis. La date est tronquée pour donner une date reposant uniquement sur le fuseau horaire spécifié.
3 Date format (Format de date) doit être exprimé en secondes ou en millisecondes (epoch). Time zone (Fuseau horaire) est ignoré. Les dates exprimées en millisecondes ou en secondes sont toujours représentées dans le fuseau horaire UTC.
4 Geometry format (Format de géométrie) et Spatial reference (Référence spatiale) sont ignorés. Pour modifier la référence spatiale d’un champ de géométrie, utilisez plutôt l’outil Project geometry (Projeter la géométrie).
5 Geometry format (Format de géométrie) doit être compatible avec le type de champ en entrée. Les champs d’entrée de chaîne doivent utiliser un format WKT, GeoJSON ou EsriJSON. Les champs d’entrée Struct doivent utiliser un format GeoJSON ou EsriJSON. Les champs binaires doivent utiliser un format WKB.
Sorties
La sortie de l’outil contient le jeu de données en entrée avec les champs qui viennent d’être mis à jour. Si les valeurs de champ ne peuvent pas être converties vers le nouveau type, la valeur obtenue sera null et n’apparaîtra pas dans la sortie.
Licences requises
Les licences et configurations suivantes sont requises :
- Type d’utilisateur Creator ou Professional
- Rôle d’éditeur, de facilitateur ou d’administrateur, ou rôle personnalisé équivalent
Afin d’en savoir plus sur la configuration requise pour Data Pipelines, reportez-vous à la rubrique Conditions requises.
Vous avez un commentaire à formuler concernant cette rubrique ?