Tous les produits
Search
Centre de documentation

ApsaraDB for OceanBase (Deprecated):Créer une table

Dernière mise à jour :Aug 09, 2026

Cette rubrique explique comment créer une table dans la console ODC.

Informations contextuelles

OceanBase Developer Center (ODC) vous permet de créer une table via une interface graphique.

Créer une table interne

image

La procédure comprend sept étapes :

  1. Spécifiez les informations de base.

  2. Créez la table.

  3. Définissez les index. (Facultatif)

  4. Définissez les contraintes. (Facultatif)

  5. Définissez les règles de partitionnement. (Facultatif)

  6. Vérifiez l'instruction SQL.

  7. Finalisez la création de la table.

Créer une table externe

Une table externe est un objet logique dont les données sont stockées dans un système de stockage externe plutôt que dans la base de données. Pour plus d'informations sur les tables externes, consultez la page Présentation.

À partir de la version ODC V4.3.3, vous pouvez créer une table externe en exécutant des instructions SQL dans la fenêtre SQL, et mapper un fichier externe à une base de données gérée par ODC en spécifiant le chemin du fichier. Vous pouvez consulter les tables externes existantes dans l'arborescence des ressources de la fenêtre SQL. Pour plus d'informations, voir Créer une table externe.

Utilisez l'instruction CREATE EXTERNAL TABLE pour créer une table externe.

Important
  • Les tables externes sont en lecture seule. Vous pouvez interroger une table externe, mais vous ne pouvez pas effectuer d'opérations LMD (Langage de Manipulation de Données) sur celles-ci.

  • Vous devez spécifier la variable secure_file_priv avant de créer une table externe dans ODC à l'aide d'un fichier local. Pour définir cette variable, vous devez vous connecter à OceanBase Database uniquement via un socket Unix local. ODC ne prend pas en charge cette méthode de connexion ; vous devez utiliser obclient pour configurer la connexion. Pour plus d'informations, consultez la documentation relative à secure_file_priv.

  1. Créez un fichier externe.

  2. Créez une table externe dans la fenêtre SQL d'ODC en exécutant des instructions SQL.

  3. Consultez la table externe dans l'arborescence des ressources.

Procédure

Créer une table dans la base de données physique

Dans l'exemple suivant, une table nommée employee est créée dans la console ODC. Cette table contient les colonnes emp_no, birthday, name et gender.

Remarque

Les données utilisées dans cette rubrique sont fournies à titre d'exemple. Remplacez-les par vos données réelles selon vos besoins.

Étape 1 : Spécifier les informations de base

  1. Connectez-vous à la console ODC et cliquez sur le nom de la connexion souhaitée pour accéder à la page de gestion de connexion correspondante. Cliquez sur Table dans le volet de navigation de gauche pour afficher les tables. Pour créer une table, cliquez sur le signe plus (+) en haut à droite de la liste des tables ou sur Create dans la barre de navigation supérieure.

  2. Dans la section Basic Info, définissez les paramètres Table Name et Description.

    image.png

    Remarque
    • En mode MySQL, vous devez également définir les paramètres Default Character Set et Default Collation.

    • Une fois les informations de base spécifiées et après être passé à l'étape « Définir les colonnes », les informations de base sont soumises.

Étape 2 : Définir les colonnes

Remarque

À partir d'ODC V4.2.3, vous pouvez créer une table contenant des colonnes de types de données spatiales dans OceanBase Database en mode MySQL ou dans MySQL Database.

La figure et le tableau ci-dessous présentent les informations à spécifier lors de l'ajout d'une colonne.

image

Le tableau suivant décrit les opérations disponibles sur la page de configuration des colonnes.

Opération

Description

Opérations de la barre d'outils

Ajoutez ou supprimez des colonnes à l'aide de la barre d'outils supérieure de la page.

Cliquer sur un ID de ligne

  • Cliquez sur un ID de ligne pour sélectionner la ligne et afficher un menu contextuel permettant d'ajouter ou de supprimer la ligne.

  • Cliquez sur un numéro de ligne pour sélectionner la ligne, puis faites-la glisser pour ajuster l'ordre de la ligne entière.

Clic droit sur une ligne

Effectuez un clic droit sur une ligne pour la sélectionner, puis choisissez Copier ou Déplacer vers le bas dans le menu contextuel qui s'affiche.

Remarque
  • Après avoir copié une ligne, collez-la à l'aide des raccourcis clavier Command + V ou Ctrl + V.

  • La section d'édition auxiliaire située en bas de la page affiche des informations supplémentaires sur la colonne sélectionnée.

  • Les informations de base et les paramètres des colonnes sont obligatoires. Les configurations des autres étapes sont facultatives. Une fois les informations de base et les paramètres des colonnes définis, soumettez les paramètres et confirmez l'instruction SQL pour créer la table.

Étape 3 : Définir les index

Si une table contient un grand volume de données, utilisez des index pour accélérer les requêtes. Un index est une structure de données qui trie préalablement les valeurs d'une ou plusieurs colonnes d'une table. Grâce aux index, vous pouvez localiser directement les enregistrements répondant aux conditions spécifiées.

La figure et le tableau ci-dessous indiquent les informations à spécifier lors de la configuration d'un index.

image

La page de configuration des index propose les icônes suivantes.

Icône

Description

Créer

Cliquez sur cette icône pour créer un index.

Supprimer

Cliquez sur cette icône pour supprimer l'index sélectionné.

Étape 4 : Définir les contraintes

Les contraintes servent à spécifier des règles de données pour une table. Toute opération de données violant ces contraintes est interrompue.

image

ODC prend en charge les quatre types de contraintes de table suivants :

  • Contrainte PRIMARY KEY : définit une clé primaire pour identifier de manière unique chaque ligne de données dans la table. Une contrainte PRIMARY KEY peut porter sur un champ ou un groupe de champs. Vous ne pouvez définir qu'une seule contrainte PRIMARY KEY par table, et vous ne pouvez pas la modifier après sa configuration.

  • Contrainte UNIQUE : garantit l'unicité des données dans un champ ou un groupe de champs au sein de la table. Vous pouvez définir plusieurs contraintes UNIQUE dans une même table.

  • Contrainte FOREIGN KEY : associe une ou plusieurs colonnes entre deux tables. Elle sert à maintenir la cohérence et l'intégrité des données entre les tables associées. Une fois les contraintes FOREIGN KEY configurées, vous ne pouvez ni en créer de nouvelles ni modifier celles qui existent.

  • Contraintes CHECK : vérifient les données dans la base de données selon les règles de contrôle configurées lors de l'édition des données. La modification des données n'est autorisée qu'après validation de la vérification.

OceanBase Database prend en charge différentes contraintes selon les modes MySQL et Oracle, et chaque type de contrainte requiert des informations spécifiques. Par conséquent, spécifiez les informations requises en fonction de la contrainte sélectionnée et des exigences affichées sur la page.

La page de configuration des contraintes propose les icônes suivantes.

Icône

Description

Créer

Cliquez sur cette icône pour créer une contrainte.

Supprimer

Cliquez sur cette icône pour supprimer la contrainte sélectionnée.

Étape 5 : Définir les règles de partitionnement

image

Vous pouvez partitionner une table contenant un grand volume de données. Après le partitionnement, les données de la table sont stockées dans plusieurs espaces de table. La base de données n'analyse pas la table entière lors d'une requête.

  • En mode MySQL, OceanBase Database prend en charge les méthodes de partitionnement suivantes : KEY, HASH, RANGE, RANGE COLUMNS, LIST et LIST COLUMNS.

  • En mode Oracle, OceanBase Database prend en charge les trois méthodes de partitionnement suivantes : List, Range et Hash.

Étape 6 : Confirmer l'instruction SQL

image.png

Après avoir cliqué sur Execute, visualisez l'instruction sur la page de confirmation SQL. Vous avez la possibilité de vérifier et de formater l'instruction.

La syntaxe est la suivante :

CREATE TABLE table_name (column_name column_type, column_name column_type,.......);

Le tableau suivant décrit les champs de la syntaxe.

Champ

Description

CREATE TABLE

Mot-clé indiquant la création d'une table avec un nom spécifié. Vous devez disposer de l'autorisation de créer des tables.

table_name

Nom de la table. Le nom doit respecter les règles de dénomination des identificateurs.

column_name column_type

Nom et type de données de chaque colonne de la table. Séparez les tuples de plusieurs colonnes par des virgules (,).

Étape 7 : Finaliser la création de la table

Cliquez sur Execute. Une fois la table créée, la table employee apparaît dans la liste des tables du volet de navigation de gauche.

image.png

Remarque

Cliquez sur l'icône Plus à côté d'un nom de table dans la liste des tables du volet de navigation de gauche, puis sélectionnez View Table Schema, View Table Data, Import, Export, Download, Mock Data, Open SQL Window, Copy, Delete ou Refresh dans le menu contextuel pour gérer ou manipuler la table.

Pour plus d'informations, consultez la rubrique Gestion des attributs de table.

Utilisez l'instruction SELECT pour interroger les données de la nouvelle table.

La syntaxe est la suivante :

SELECT
 column_name,
 column_name
FROM
 table_name [WHERE Clause] [LIMIT N] [ OFFSET M]

Le tableau suivant décrit les champs de la syntaxe.

Champ

Description

SELECT

Mot-clé indiquant le nom de l'instruction. L'instruction SELECT permet de lire un ou plusieurs enregistrements.

column_name

Nom de la colonne à interroger. Utilisez un astérisque () sous la forme pour interroger toutes les colonnes.

WHERE

Mot-clé de la clause de condition.

LIMIT

Nombre d'enregistrements à renvoyer.

OFFSET

Décalage des données à partir duquel l'instruction SELECT commence l'interrogation. Le décalage par défaut est 0.

Voici un exemple :

SELECT `emp_no`, `birthdate`, `name`, `gender` FROM `employee`;

image.png

Créer une table externe

L'exemple de cette section explique comment créer une table externe nommée employee dans la base de données odc_test gérée par ODC, via la fenêtre SQL, en mappant un fichier spécifié dans Alibaba Cloud Object Storage Service (OSS) vers la base de données odc_test.

  1. Créez un fichier externe.

    1. Créez un répertoire nommé external table sur Se connecter à la console OSS avec un compte Alibaba Cloud.

      image

    2. Téléchargez le fichier employee.csv dans le répertoire external table.

      image

    3. Copiez le chemin de la table employee, par exemple https://ob*****.oss-cn-shanghai.aliyuncs.com/doc/img/odc/433/external%20table/employee.csv.

      image

  2. Dans la fenêtre SQL d'ODC, exécutez l'instruction SQL suivante pour créer une table externe nommée employee.

    image

    CREATE EXTERNAL TABLE `employee` (
       `emp_no` int(120),
       `birthday` date,
       `name` varchar(120)
    )
       LOCATION = 'ob*********.oss-cn-shanghai.aliyuncs.com/doc/img/odc/433/500.sql-development/700.database-objects/100.web-odc-table-objects/employee/employee.csv'
       FORMAT = (
          TYPE = 'CSV'
          FIELD_DELIMITER = ','
          FIELD_OPTIONALLY_ENCLOSED_BY ='"'
          ENCODING = 'utf8mb4'
          )
       PATTERN = 'employee.csv';
    
    • L'option LOCATION spécifie le chemin de stockage de la table externe.

      • Format d'emplacement local : LOCATION = '[file://] local_file_path'. Lorsque vous utilisez ce format, vous devez définir la variable système secure_file_priv pour spécifier un chemin accessible. Pour plus d'informations, consultez secure_file_priv.

      • Format d'emplacement distant : LOCATION = '{oss|cos|S3}://$ACCESS_ID:$ACCESS_KEY@$HOST/remote_file_path'. Dans ce format, $ACCESS_ID, $ACCESS_KEY et $HOST sont requis pour accéder à Alibaba Cloud OSS, Tencent Cloud Object Storage (COS) ou Amazon Simple Storage Service (S3).

    • L'option FORMAT = ( TYPE = 'CSV'... ) spécifie le format d'un fichier externe CSV. Les paramètres sont décrits ci-dessous :

      • TYPE : type du fichier externe.

      • LINE_DELIMITER : délimiteur de ligne pour le fichier CSV. La valeur par défaut est '\n'.

      • FIELD_DELIMITER : délimiteur de champ pour le fichier CSV. La valeur par défaut est '\t'.

      • ESCAPE : caractère d'échappement pour le fichier CSV, qui ne peut avoir qu'une longueur de 1 octet. La valeur par défaut est '\'.

      • FIELD_OPTIONALLY_ENCLOSED_BY : caractères entourant les valeurs de champ dans le fichier CSV. Par défaut, ce paramètre est vide.

      • ENCODING : encodage du jeu de caractères utilisé par le fichier. Pour plus d'informations sur tous les jeux de caractères pris en charge en mode MySQL, consultez Jeux de caractères. Si ce paramètre n'est pas spécifié, la valeur par défaut UTF8MB4 s'applique.

      • NULL_IF : chaînes à traiter comme des valeurs NULL. Par défaut, ce paramètre est vide.

      • SKIP_HEADER : indique s'il faut ignorer l'en-tête du fichier et spécifie le nombre de lignes à ignorer.

      • SKIP_BLANK_LINES : indique s'il faut ignorer les lignes vides. La valeur par défaut est FALSE, ce qui signifie que les lignes vides ne sont pas ignorées.

      • TRIM_SPACE : indique s'il faut supprimer les espaces de début et de fin des champs du fichier. La valeur par défaut est FALSE, ce qui signifie que les espaces ne sont pas supprimés.

      • EMPTY_FIELD_AS_NULL : indique s'il faut traiter les chaînes vides comme des valeurs NULL. La valeur par défaut est FALSE, ce qui signifie que les chaînes vides ne sont pas traitées comme des valeurs NULL.

    • L'option PATTERN spécifie une chaîne de modèle régulière pour filtrer les fichiers dans le répertoire LOCATION. Pour chaque fichier du répertoire spécifié par LOCATION, si le chemin du fichier correspond à la chaîne de modèle, la table externe accède au fichier. Sinon, elle l'ignore. Par défaut, si ce paramètre n'est pas spécifié, tous les fichiers du répertoire LOCATION sont accessibles. La table externe stocke la liste des fichiers correspondant à la chaîne spécifiée par PATTERN dans la table système de la base de données. Lors d'une analyse, la table externe accède aux fichiers externes en se basant sur cette liste.

  3. Dans le volet de navigation de gauche, consultez la table employee dans le répertoire des tables externes.

    image

Références