ApsaraDB for OceanBase (Deprecated):Direct load

Visão geral

O OceanBase Database permite inserir dados em um banco de dados usando direct load. Esse recurso ignora as APIs convencionais da camada SQL e grava dados diretamente nos arquivos do banco, aumentando a eficiência da importação. Para mais informações, consulte Visão geral.

Pré-requisitos

Antes de ativar o direct load, verifique se as seguintes condições foram atendidas:

• O cluster atual está em execução.

• O tenant atual está em execução.

• A versão do OceanBase Database Proxy (ODP) é V4.3.0 ou posterior.

  Nota

  Se a versão do ODP não atender ao requisito, entre em contato com o Suporte Técnico do OceanBase para obter assistência na atualização.

• O endereço privado do endereço principal está em execução.

Ativar o direct load

1. Faça login no console do ApsaraDB for OceanBase.

2. No painel de navegação à esquerda, clique em Instances.

3. Na lista de instâncias, clique no nome da instância de cluster desejada para acessar a página Cluster Instance Workspace.

4. No painel de navegação à esquerda, clique em Database Proxy.

5. Na lista de endereços de proxy, clique em Enable para ativar o direct load no endereço privado do endereço principal.

6. Na janela de confirmação exibida, clique em OK.

Importar dados

1. Baixe a versão mais recente do obloader & obdumper.

   Para mais informações, consulte Introdução.

2. Visualize e defina as variáveis de ambiente.

   1. Visualize as variáveis de ambiente Java e 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. Defina as variáveis de ambiente Java e 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. Importe os dados no modo direct load.

   Nota

   O formato do conteúdo do arquivo importado deve atender às especificações relacionadas. Identifique o formato dos dados no arquivo conforme descrito em Seus dados estão prontos?.

   [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

   Parâmetro	Descrição
   -h	Endereço do host do banco de dados OceanBase.
   -u	Nome de usuário, nome do tenant e nome do cluster para conexão ao banco de dados OceanBase, no formato <user>@<tenant>#<cluster>, como -u user@tenant#cluster.
   -p	Senha para conexão ao banco de dados OceanBase.
   -D	Nome do banco de dados OceanBase onde as definições de objetos e os dados das tabelas serão importados.
   --table	Tabela de destino para importação de dados, por exemplo, --table 'example'.
   -f	Prefixo do nome do arquivo a ser importado. No comando anterior, por exemplo, os dados residem em um arquivo com o prefixo output1.
   -t	Nome do tenant do OceanBase Database utilizado na conexão. Utilize este parâmetro em conjunto com --public-cloud.
   --public-cloud	Importa definições de objetos de banco de dados ou dados de tabelas de um cluster ApsaraDB for OceanBase.
   --csv	Importa dados de um arquivo CSV. Especifique outro formato de arquivo conforme necessário, como --sql, --par ou --orc.
   --direct	Importa dados no modo direct load. Combine este parâmetro com --rpc-port e --parallel.
   --parallel	Grau de paralelismo (DOP) para carregamento de dados no modo direct load. O valor padrão é 1. Este parâmetro é opcional e deve ser usado com --rpc-port e --direct.
   --rpc-port 3307	Porta RPC para conexão ao banco de dados OceanBase. Embora a porta de conexão ao banco seja 3306 (definida por -P 3306), a importação utiliza o serviço RPC na porta 3307 para melhorar o desempenho.
   -P 3306	Porta do host para conexão ao banco de dados OceanBase.

Desativar o direct load

1. Faça login no console do ApsaraDB for OceanBase.

2. No painel de navegação à esquerda, clique em Instances.

3. Na lista de instâncias, clique no nome da instância de cluster desejada para acessar a página Cluster Instance Workspace.

4. No painel de navegação à esquerda, clique em Database Proxy.

5. Na lista de endereços de proxy, clique em Disable para desativar o direct load no endereço privado do endereço principal.

6. Na janela de confirmação exibida, clique em OK.