Rôle
Crée un nouvel identifiant pour chaque ligne. Choisissez la méthode selon que vous avez besoin d’une unicité aléatoire, d’une séquence commune à plusieurs exécutions ou d’une simple numérotation du jeu de données actuel.
Entrées et sorties
Une entrée in ; out contient la nouvelle colonne d’identifiant et tous les champs d’origine.
Paramètres
| Le paramètre | Réglages et valeurs | Options et limites |
|---|---|---|
field | Le nom du nouveau champ ; ID par défaut. | Par défaut : IDJusqu’à 256 caractères |
mode | guid — UUID v4 ; snowflake — identifiant 64 bits sous forme de texte ; sequence — séquence. | Options : guid, snowflake, sequencePar défaut : guid |
start | Le numéro initial de la séquence. | Par défaut : 1Limites : -9007199254740991…9007199254740991 |
step | Un incrément positif de 1 à 1 000 000. | Par défaut : 1Limites : 1…1 000 000 |
worker_id | L’identifiant d’installation pour Snowflake, de 0 à 1 023. | Par défaut : 0Limites : 0…1 023 |
scope | run redémarre la séquence ; persistent la poursuit d’une exécution à l’autre. | Options : run, persistentPar défaut : run |
sequence_key | Un nom unique et partagé de séquence persistante. | Par défaut : emptyJusqu’à 128 caractères |
Configuration étape par étape
- Définissez un nom de champ qui n’existe pas déjà dans le tableau.
- Choisissez la méthode de génération.
- Pour sequence, définissez start, step et scope ; pour persistent, définissez sequence_key.
- Pour Snowflake, coordonnez worker_id avec les autres installations indépendantes.
- Vérifiez le type du champ cible et si les interruptions dans la numérotation sont acceptables.
Règles et diagnostics
- Un champ existant n’est pas écrasé : ID_COLUMN_CONFLICT exige un autre nom.
- L’aperçu génère de nouveaux identifiants. La réservation persistante peut laisser des trous après des vérifications, erreurs ou annulations ; les numéros ne sont pas restitués.
- L’incrément d’une séquence persistante existante ne peut pas être modifié — utilisez une autre valeur sequence_key.
- Snowflake est transmis sous forme de texte pour préserver la précision et nécessite des valeurs worker_id différentes dans les systèmes indépendants. Un recul important de l’horloge arrête la génération.
- Une séquence limitée à l’exécution actuelle ne garantit pas l’unicité entre différentes exécutions.
Exemple de configuration
Pour les lignes d’un export de contrôle, utilisez field=RowNo, mode=sequence, start=1, step=1, scope=run. Pour un numéro de demande persistant, définissez scope=persistent et sequence_key=Requests.