Qu'est-ce que le fichier dbtune ?

Le fichier de configuration dbtune fournit les valeurs initiales de la table DBTUNE.

Après la création de la table DBTUNE, le fichier dbtune peut être utilisé pour ajouter de nouveaux mots-clés de configuration à la table DBTUNE.

Le fichier dbtune se trouve initialement dans le répertoire etc de SDEHOME. Lorsque la commande sdesetup s'exécute (ou lorsque vous exécutez l'assistant de post-installation d'ArcSDE sur les systèmes Windows), les paramètres de configuration sont lus dans le fichier et écrits dans la table DBTUNE. Si le fichier dbtune est absent, vide ou non spécifié, la table DBTUNE est créée et renseignée à l'aide des mots-clés de configuration par défaut représentant la configuration ArcSDE minimale. Dans de nombreux cas, vous renseignez la table DBTUNE avec des paramètres de stockage spécifiques à votre base de données.

L'installation ArcSDE pour Oracle Windows inclut plusieurs versions du fichier dbtune, chacune spécifiant un stockage de géométrie différent dans le mot-clé DEFAULTS. Si vous effectuez une nouvelle installation d'ArcSDE pour Oracle (sans mettre à niveau la base de données), vous pouvez utiliser l'une des versions alternatives du fichier pour renseigner votre table DBTUNE pendant la configuration post-installation si vous souhaitez que votre stockage de géométrie par défaut soit d'un type différent du type ST_GEOMETRY.

Remarque :

Si vous utilisez ArcSDE pour Oracle, DB2 ou PostgreSQL, vous devez annuler les commentaires de certains paramètres sous le mot-clé DATA_DICTIONARY et modifier les chaînes de configuration associées pour spécifier un nom de tablespace avant de créer la géodatabase. Il existe également des paramètres commentés sous tous les autres mots-clés dont vous devez supprimer les commentaires et pour lesquels vous devez spécifier un nom de tablespace avant de commencer à ajouter des données à votre géodatabase. Les lignes commentées sont précédées d'un signe dièse seul (#). Supprimez ce signe et remplacez le <texte> par le nom du tablespace correct.

Anatomie d'un fichier dbtune

L'exemple suivant est issu d'un fichier dbtune.sde SQL Server. Chaque numéro, décrit après l'illustration, correspond à un composant du fichier dbtune.

1. Mots-clés de configuration—Les mots-clés sont précédés de deux signes dièse (##) dans le fichier dbtune. Ces signes dièse ne font pas réellement partie du mot-clé ; ils ne sont pas stockés dans la table DBTUNE. Dans le fichier dbtune.sde, ils indiquent la ligne du fichier dbtune qui contient le mot-clé de configuration.
   Remarque :

   Assurez-vous qu'il n'y a aucun espace entre les signes dièse ou entre les signes dièse et le mot-clé de configuration dans le fichier dbtune. S'il existe des espaces, ArcSDE lira le mot-clé comme faisant partie du mot-clé précédent.

   ArcSDE enregistre le mot-clé de configuration (ou DEFAULTS si aucun n'est spécifié) pour chaque couche dans les tables système. Il enregistre également un mot-clé pour les tables non spatiales créées dans la géodatabase. Chaque fois que vous créez un nouvel objet pour une couche ou une table enregistrée (par exemple, un index), ArcSDE utilise les valeurs de paramètre courantes dans la table DBTUNE pour le mot-clé ayant été utilisé pour créer la table. Par exemple, si vous créez un index de colonne avec sdetable –o create_index, ArcSDE se réfère à la table DBTUNE afin de trouver les informations de stockage ayant été utilisées pour créer la table et les utilise pour créer l'index. Pour cette raison, soyez prudent si vous supprimez des entrées DBTUNE.
2. Nom de paramètre—Les paramètres sont répartis en trois types élémentaires : méta, table et index. Les métaparamètres définissent le mode de stockage de certains types de données, l'environnement d'un mot-clé de configuration ou un commentaire décrivant ce mot-clé de configuration. Les paramètres de table définissent la configuration de stockage d'une table de base de données. Lorsqu'une application cliente envoie une instruction CREATE TABLE, ArcSDE ajoute la chaîne de configuration associée au paramètre à l'instruction CREATE TABLE avant de soumettre l'instruction à la base de données. Les paramètres d'index définissent la configuration de stockage d'un index SGBD. Lorsqu'une application cliente envoie une instruction CREATE TABLE, ArcSDE ajoute le paramètre d'index à cette instruction avant de soumettre l'instruction à la base de données.

   Par exemple, si vous créez une couche dans votre base de données SQL Server ou Oracle et choisissez le mot-clé WKB_GEOMETRY, ArcSDE ajoute GEOMETRY_STORAGE ="OGCWKB" à l'instruction CREATE TABLE qu'il envoie à la base de données.

   Reportez-vous à la rubrique Que sont les mots-clés et les paramètres de configuration DBTUNE ? pour plus d'informations sur les mots-clés et les paramètres.

3. Chaîne de configuration—Une valeur de chaîne de configuration peut couvrir plusieurs lignes. Si la valeur est une valeur de chaîne réelle, elle doit être mise entre guillemets doubles dans le fichier dbtune. Les valeurs booléennes ou numériques ne nécessitent pas de guillemets. Dans certains systèmes de gestion de bases de données (SGBD), les guillemets doubles sans espace entre eux indiquent qu'une valeur est vierge. Les guillemets doubles sont utilisés pour signifier une valeur littérale dans le fichier dbtune.sde ; ils ne font pas partie de la valeur stockée dans la table DBTUNE.

   La chaîne de configuration est toujours associée à un nom de paramètre et fournit les caractéristiques décrivant la manière dont un objet est créé et stocké dans la base de données.

4. Mot-clé END—Chaque groupe de paramètres doit être suivi du mot-clé END. Si le mot-clé END est absent de la fin d'un groupe de paramètres, le fichier ne peut pas être chargé dans la table DBTUNE.

Vous pouvez spécifier un nombre quelconque de groupes de paramètres dans un fichier dbtune. Toutefois, certains groupes et certains noms de paramètre doivent normalement exister et sont automatiquement créés dans la table DBTUNE s'ils ne figurent pas dans le fichier dbtune.sde.

Des commentaires peuvent être placés dans le fichier dbtune et sont signalés par un signe dièse seul (#). La version par défaut du fichier dbtune.sde fournie avec votre installation du composant ArcSDE contient des lignes commentées. Ces lignes sont utilisées comme espaces texte réservés pour certains paramètres de stockage, que vous pouvez utiliser en supprimant le caractère de commentaire et en éditant la ligne.