Tous les produits
Search
Centre de documentation

ApsaraDB for OceanBase (Deprecated):Chargement direct

Dernière mise à jour :Aug 09, 2026

Cette rubrique explique comment activer et désactiver le chargement direct dans la console ApsaraDB for OceanBase.

Présentation

OceanBase Database permet d'insérer des données via le chargement direct. Cette fonctionnalité contourne les API conventionnelles de la couche SQL pour écrire directement les données dans les fichiers de la base de données, ce qui améliore l'efficacité de l'importation. Pour plus d'informations, consultez la page Overview.

Prérequis

Avant d'activer le chargement direct, vérifiez que les conditions suivantes sont remplies :

  • Le cluster est en cours d'exécution.

  • Le locataire (tenant) est en cours d'exécution.

  • La version d'OceanBase Database Proxy (ODP) est la V4.3.0 ou une version ultérieure.

    Remarque

    Si la version d'ODP ne répond pas à cette exigence, contactez le support technique OceanBase pour vous aider à effectuer la mise à niveau.

  • L'adresse privée de l'adresse principale est active.

Activer le chargement direct

  1. Connectez-vous à la console ApsaraDB for OceanBase.

  2. Dans le volet de navigation de gauche, cliquez sur Instances.

  3. Dans la liste des instances, cliquez sur le nom de l'instance de cluster cible pour accéder à la page Cluster Instance Workspace.

  4. Dans le volet de navigation de gauche, cliquez sur Database Proxy.

  5. Dans la liste des adresses de proxy, cliquez sur Enable pour activer le chargement direct pour l'adresse privée de l'adresse principale.

  6. Dans la fenêtre de confirmation, cliquez sur OK.

Importer des données

  1. Téléchargez la dernière version de obloader & obdumper.

    Pour plus d'informations, consultez la section Introduction.

  2. Consultez et définissez les variables d'environnement.

    1. Vérifiez les variables d'environnement Java et PATH.

      [root@iZbxxxx rpc]# env | grep JAVA
      JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.382.b05-2.0.3.al8.x86_64
      [root@iZbxxxx rpc]# env | grep PATH
      PATH=/root/ob-loader-dumper-4.3.0-RELEASE/bin/:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin
    2. Définissez les variables d'environnement Java et PATH.

      [root@iZbxxxx rpc]# export JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.382.b05-2.0.3.al8.x86_64
      [root@iZbxxxx rpc]# export PATH=/root/ob-loader-dumper-4.3.0-RELEASE/bin/:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/root/bin:$PATH
  3. Importez des données en mode de chargement direct.

    Remarque

    Le format du contenu du fichier importé doit respecter les spécifications applicables. Identifiez le format des données dans le fichier en vous référant à la section Is your data ready?

    [root@iZbxxxx rpc]# obloader -h<host> -u<user_name> -p<pass_word> -D <db_name> --table '<table_name>' -f output1 -t <tenant_name> --public-cloud --csv --direct --rpc-port 3307 -P3306
    |
    **Parameter**
    |
    **Description**
    | | --- | --- | |
    -h
    |
    L'adresse hôte de la base de données OceanBase.
    | |
    -u
    |
    Le nom d'utilisateur, le nom du locataire (tenant) et le nom du cluster pour la connexion à la base de données OceanBase, au format `@#`, par exemple `-u user@tenant#cluster`.
    | |
    -p
    |
    Le mot de passe pour la connexion à la base de données OceanBase.
    | |
    -D
    |
    Le nom de la base de données OceanBase dans laquelle les définitions d'objets de base de données et les données de table doivent être importées.
    | |
    --table
    |
    La table dans laquelle les données doivent être importées, par exemple `--table 'example'`.
    | |
    -f
    |
    Le préfixe du nom du fichier à importer. Par exemple, dans la commande précédente, les données à importer sont stockées dans un fichier dont le préfixe est `output1`.
    | |
    -t
    |
    Le nom du locataire (tenant) d'OceanBase Database auquel vous vous connectez. Ce paramètre est utilisé conjointement avec le paramètre `--public-cloud`.
    | |
    --public-cloud
    |
    Importe les définitions d'objets de base de données ou les données de table depuis un cluster ApsaraDB for OceanBase.
    | |
    --csv
    |
    Importe des données depuis un fichier CSV. Vous pouvez spécifier un autre format de fichier selon vos besoins, tel que `--sql`, `--par` ou `--orc`.
    | |
    --direct
    |
    Importe des données en mode de chargement direct. Ce paramètre est utilisé conjointement avec les paramètres `--rpc-port` et `--parallel`.
    | |
    --parallel
    |
    Le degré de parallélisme (DOP) pour le chargement des données en mode de chargement direct. La valeur par défaut est 1. Ce paramètre est facultatif et utilisé conjointement avec les paramètres `--rpc-port` et `--direct`.
    | |
    --rpc-port 3307
    |
    Le port RPC pour la connexion à la base de données OceanBase.


    Bien que le port de connexion à la base de données soit 3306, spécifié par -P 3306, les données sont importées via le service RPC sur le port 3307 afin d'améliorer les performances d'importation.
    | |
    -P 3306
    |
    Le port hôte pour la connexion à la base de données OceanBase.
    |


























































Désactiver le chargement direct

  1. Connectez-vous à la console ApsaraDB for OceanBase.

  2. Dans le volet de navigation de gauche, cliquez sur Instances.

  3. Dans la liste des instances, cliquez sur le nom de l'instance de cluster cible pour accéder à la page Cluster Instance Workspace.

  4. Dans le volet de navigation de gauche, cliquez sur Database Proxy.

  5. Dans la liste des adresses de proxy, cliquez sur Disable pour désactiver le chargement direct pour l'adresse privée de l'adresse principale.

  6. Dans la fenêtre de confirmation, cliquez sur OK.