Tablestore:Uso do Tablestore com PrestoDB

Etapa 1: Conectar o PrestoDB ao Tablestore

Após instalar o PrestoDB, configure o catálogo e o schema para estabelecer a conexão com o Tablestore. O arquivo de configuração do catálogo encontra-se em etc/catalog/tablestore.properties.

Etapa 2: Executar a CLI SQL do Presto

Com a conexão estabelecida, inicie o Presto Server e execute instruções SQL.

1. Obtenha o arquivo executável do cliente.

   1. Baixe o cliente PrestoDB.

      Este tópico usa presto-cli-0.280-executable.jar como exemplo.

   2. Salve o cliente PrestoDB no diretório bin da pasta de instalação do PrestoDB.

   3. No diretório bin da instalação do PrestoDB, execute o comando abaixo para obter o arquivo executável do cliente.

      # Rename the PrestoDB client file to presto. Replace presto-cli-0.280-executable.jar with the name of your client version.
      mv presto-cli-0.280-executable.jar presto
      # Grant the user permissions to operate the presto file.
      chmod +x presto

2. No diretório bin da instalação do PrestoDB, execute o comando para iniciar o Presto Server.

   Importante

   Ao iniciar o Presto Server, inicie o coordenador (coordinator) e pelo menos um trabalhador (worker).

   # You can start the server in the foreground or background. The foreground mode is more convenient for viewing operational logs.
   # Method 1: Run in the background
   ./launcher start
   # Method 2: Run in the foreground
   ./launcher run

3. No diretório bin da instalação do PrestoDB, execute o seguinte comando para iniciar a CLI SQL.

   Nota

   • Por padrão, o PrestoDB opera na porta 8080. Para alterá-la, modifique a configuração http-server.http.port no arquivo etc/config.properties.

   • Após alterar configurações, reinicie o servidor para aplicar as mudanças.

   • No comando, ./presto representa o caminho relativo do executável do cliente dentro do diretório bin da instalação do PrestoDB.

   ./presto --server localhost:8080 --catalog tablestore --schema default

   A tabela abaixo detalha os itens de configuração.

   Item de configuração	Exemplo	Obrigatório	Descrição
   --server	localhost:8080	Sim	URI do Presto Server. Substitua o valor conforme necessário. Esta configuração deve ser idêntica ao parâmetro discovery.uri no arquivo etc/config.properties do diretório de instalação do PrestoDB.
   --catalog	tablestore	Sim	Nome do arquivo de configuração do catálogo. Defina como tablestore, correspondendo ao nome do arquivo criado.
   --schema	default	Sim	Configuração do schema. Mantenha o valor padrão.

Etapa 3: Criar um schema e uma tabela de mapeamento

Ao optar pela configuração dinâmica de schema com meta table, crie manualmente um schema para configurar a instância do Tablestore conectada e realizar a autenticação do usuário. Em seguida, crie uma tabela de mapeamento para a tabela do Tablestore, permitindo consultas e análises.

1. Execute o comando abaixo para criar um schema.

   O exemplo a seguir demonstra a criação de um Schema chamado testdb para acessar a instância myinstance do Tablestore.

   CREATE SCHEMA tablestore.testdb
   WITH (
     endpoint = 'https://myinstance.cn-hangzhou.ots.aliyuncs.com',
     instance_name = 'myinstance',
     access_id = '************************',
     access_key = '********************************'
   );

   Consulte a tabela abaixo para a descrição dos parâmetros.

   Parâmetro	Exemplo	Obrigatório	Descrição
   endpoint	https://myinstance.cn-hangzhou.ots.aliyuncs.com	Sim	Endpoint da instância do Tablestore. Para mais informações, consulte Endpoints.
   instance_name	myinstance	Sim	Nome da instância do Tablestore. Consulte Instances para detalhes.
   access_id		Sim	AccessKey ID da conta Alibaba Cloud ou do usuário RAM.
   access_key		Sim	AccessKey secret da conta Alibaba Cloud ou do usuário RAM.

2. Execute o comando use <SCHEMA_NAME>; para selecionar o schema criado.

   Substitua <SCHEMA_NAME> pelo nome do seu schema. Use o comando show schemas; para listar os schemas disponíveis.

3. Execute o comando a seguir para criar uma tabela de mapeamento para a tabela de dados do Tablestore.

   Importante

   Atente-se aos pontos abaixo ao criar uma tabela de mapeamento:

   • Garanta que os tipos de campo na tabela de mapeamento correspondam aos da tabela de dados do Tablestore. Consulte Field type mapping para mais informações.

   • O nome da tabela de mapeamento deve ser idêntico ao nome da tabela no Tablestore.

   • A propriedade table_name na instrução CREATE TABLE vincula a tabela do PrestoDB à tabela real no Tablestore. É possível ter múltiplas tabelas de mapeamento com nomes diferentes apontando para a mesma tabela de dados.

   • A tabela de mapeamento deve conter todas as colunas de chave primária da tabela de dados, mas pode incluir apenas um subconjunto das colunas de atributo.

   • Os nomes e a ordem das colunas de chave primária na tabela de mapeamento devem coincidir com os da tabela do Tablestore. Mapeie cada coluna de atributo à sua equivalente no Tablestore usando o parâmetro origin_name.

   Considere uma tabela de dados chamada main_table, contendo duas colunas de chave primária (gid e uid) e três colunas de atributo (col1, col2 e col3).

   O exemplo SQL abaixo cria uma tabela de mapeamento com o mesmo nome para a tabela de dados main_table do Tablestore.

   CREATE TABLE if not exists main_table
   (
      gid bigint,
      uid bigint,
      c1 boolean with (origin_name = 'col1'),
      c2 bigint with (origin_name = 'col2'),
      c3 varchar with (origin_name = 'col3')
   ) WITH (
      table_name = 'main_table'
   );

Etapa 4: Operar dados com SQL

Instruções SQL permitem consultar configurações de schema e metadados de tabelas, além de ler e gravar dados nas tabelas do Tablestore. Para mais exemplos de SQL, consulte Common SQL examples.

1. Consulte as configurações de schema.

   • Obtenha a lista de schemas

     show schemas;

   • Liste as tabelas de um schema específico

     show tables;

2. Visualize os metadados de uma tabela específica

   Substitua <TABLE_NAME> pelo nome real da tabela.

   describe <TABLE_NAME>;

3. Opere os dados.

   Leia e grave dados no Tablestore.

   • Grave dados

     • Insira uma linha de dados

       O exemplo abaixo insere uma linha de dados na tabela main_table.

       insert into main_table values(10001,10001,true,100,'hangzhou');

     • Importe dados em lote

       Importante

       Antes de importar dados em lote, verifique se a tabela de destino já foi criada e se seu schema corresponde ao da tabela de origem.

       O exemplo a seguir importa dados das colunas gid, uid, c1, c2 e c3 da tabela main_table para sampletable, filtrando registros onde gid é maior que 0 e uid é menor que 10000.

       insert into sampletable select gid, uid, c1, c2, c3 from main_table where gid > 0 and uid < 100000;

   • Leia dados

     Este exemplo consulta linhas na tabela sampletable onde o valor da coluna gid é maior que 0, uid é menor que 10 e c1 é verdadeiro.

     select * from sampletable where gid > 0 and uid < 10 and c1 = true;