Créer une séquence de base de données (Gestion des données)

Synthèse

Crée une séquence de base de données dans une géodatabase. Vous pouvez utiliser les séquences dans les applications personnalisées qui accèdent à la géodatabase.

Utilisation

  • Cet outil peut être utilisé avec les géodatabases fichier et les géodatabases dans IBM Db2, Microsoft SQL Server, Oracle, PostgreSQL et SAP HANA.

  • Vous pouvez utiliser la fonction ListDatabaseSequences pour obtenir une liste des séquences de base de données dans une géodatabase fichier. Les noms de séquence devant être uniques, l’obtention d’une liste des séquences existantes avant la création d’une séquence vous évite de spécifier un nom déjà utilisé.

Paramètres

ÉtiquetteExplicationType de données
Espace de travail en entrée

Fichier de connexion à la base de données (.sde) permettant de se connecter à la géodatabase d’entreprise dans laquelle vous voulez créer une séquence ou chemin de la géodatabase fichier (avec le nom de la géodatabase fichier).

Pour les connexions aux bases de données, l’utilisateur spécifié dans la connexion à la base de données est le propriétaire de la séquence et doit posséder les permissions suivantes dans la base de données :

  • Db2 : privilège CREATEIN sur leur structure
  • Oracle : privilège système CREATE SEQUENCE
  • PostgreSQL : autorité sur leur structure
  • SAP HANA : doit être un utilisateur standard
  • SQL Server : privilège CREATE SEQUENCE et permission ALTER OR CONTROL sur leur structure

Workspace
Nom de la séquence

Nom à affecter à la séquence de base de données. Pour les géodatabases d’entreprise, ce nom doit remplir les critères de nom de séquence définis pour la plateforme de base de données que vous utilisez et être unique dans la base de données. Pour les géodatabases fichier, ce nom doit également être propre à la géodatabase fichier. Veillez à vous souvenir de ce nom, car il s’agit du nom que vous utilisez dans vos applications et expressions personnalisées pour appeler la séquence.

String
ID de début de la séquence
(Facultatif)

Numéro de départ de la séquence. Si vous ne fournissez pas de numéro de départ, la séquence commence par le numéro 1. Si vous fournissez un numéro de départ, il doit être supérieur à 0.

Long
Valeur d’incrément de la séquence
(Facultatif)

Décrit la façon dont sont incrémentés les numéros de séquence. Par exemple, si la séquence commence à 10 et que la valeur d’incrément est 5, la prochaine valeur dans la séquence sera 15, et la suivante 20. Si vous ne spécifiez pas de valeur d’incrément, les valeurs de séquence sont incrémentées de 1.

Long

Sortie obtenue

ÉtiquetteExplicationType de données
Séquence créée dans la géodatabase

Espace de travail en entrée mis à jour.

Espace de travail

arcpy.management.CreateDatabaseSequence(in_workspace, seq_name, {seq_start_id}, {seq_inc_value})
NomExplicationType de données
in_workspace

Fichier de connexion à la base de données (.sde) permettant de se connecter à la géodatabase d’entreprise dans laquelle vous voulez créer une séquence ou chemin de la géodatabase fichier (avec le nom de la géodatabase fichier).

Pour les connexions aux bases de données, l’utilisateur spécifié dans la connexion à la base de données est le propriétaire de la séquence et doit posséder les permissions suivantes dans la base de données :

  • Db2 : privilège CREATEIN sur leur structure
  • Oracle : privilège système CREATE SEQUENCE
  • PostgreSQL : autorité sur leur structure
  • SAP HANA : doit être un utilisateur standard
  • SQL Server : privilège CREATE SEQUENCE et permission ALTER OR CONTROL sur leur structure

Workspace
seq_name

Nom à affecter à la séquence de base de données. Pour les géodatabases d’entreprise, ce nom doit remplir les critères de nom de séquence définis pour la plateforme de base de données que vous utilisez et être unique dans la base de données. Pour les géodatabases fichier, ce nom doit également être propre à la géodatabase fichier. Veillez à vous souvenir de ce nom, car il s’agit du nom que vous utilisez dans vos applications et expressions personnalisées pour appeler la séquence.

String
seq_start_id
(Facultatif)

Numéro de départ de la séquence. Si vous ne fournissez pas de numéro de départ, la séquence commence par le numéro 1. Si vous fournissez un numéro de départ, il doit être supérieur à 0.

Long
seq_inc_value
(Facultatif)

Décrit la façon dont sont incrémentés les numéros de séquence. Par exemple, si la séquence commence à 10 et que la valeur d’incrément est 5, la prochaine valeur dans la séquence sera 15, et la suivante 20. Si vous ne spécifiez pas de valeur d’incrément, les valeurs de séquence sont incrémentées de 1.

Long

Sortie obtenue

NomExplicationType de données
out_workspace

Espace de travail en entrée mis à jour.

Espace de travail

Exemple de code

Exemple d'utilisation de l'outil CreateDatabaseSequence (fenêtre Python)

Créez une séquence de base de données nommée custom_sequence qui commence avec la valeur 1 et s’incrémente de 1.

import arcpy
arcpy.CreateDatabaseSequence_management(r"C:/myconnections/mygdb.sde", 
                                        "custom_sequence", 1, 1)
Exemple d'utilisation de l'outil CreateDatabaseSequence (fenêtre Python)

Créez une séquence de base de données nommée my_ids qui commence avec la valeur 1 et s’incrémente de 1 dans une géodatabase fichier intitulée myfilegdb.

import arcpy
arcpy.CreateDatabaseSequence_management(r"C:/geodatabases/myfilegdb.gdb", 
                                        "my_ids", 1, 1)

Rubriques connexes