Conectar ao SQL Workbench/J e gerenciar dados - MaxCompute: Central de Documentação do Alibaba Cloud

O MaxCompute permite usar a ferramenta de gerenciamento de banco de dados SQL Workbench/J para acessar seu projeto MaxCompute e realizar operações de gerenciamento de dados. Este tópico descreve como conectar o SQL Workbench/J a um projeto MaxCompute com o driver JDBC do MaxCompute e como gerenciar dados.

Informações básicas

O SQL Workbench/J é uma ferramenta gratuita e multiplataforma de consulta SQL, independente de qualquer sistema de gerenciamento de banco de dados (DBMS). Desenvolvido em Java, o SQL Workbench/J executa em qualquer sistema operacional que ofereça um ambiente de execução Java.

Pré-requisitos

Antes de prosseguir, confirme se você atende aos seguintes requisitos:

Você criou um projeto MaxCompute.

Para mais informações sobre como criar um projeto MaxCompute, consulte Criar um projeto MaxCompute.
Você obteve um AccessKey ID e um AccessKey secret com permissões de acesso ao projeto MaxCompute.

Obtenha seu AccessKey ID e AccessKey secret na página AccessKey Management.
Você baixou o driver JDBC do MaxCompute (versão 3.0.1 ou posterior) que inclui o pacote JAR completo de dependências jar-with-dependencies.

O exemplo neste tópico usa a versão 3.2.9 do driver JDBC do MaxCompute.
Você baixou e instalou o SQL Workbench/J.

O exemplo neste tópico usa o SQL Workbench/J Build 127, lançado em 22 de agosto de 2020.
Você instalou o Java 8 ou uma versão posterior.

Procedimento

Siga estas etapas para conectar o SQL Workbench/J ao MaxCompute:

Etapa 1: Criar um driver

Faça upload do arquivo JAR do driver JDBC do MaxCompute para o SQL Workbench/J para que a ferramenta acesse seu projeto MaxCompute por meio desse driver.
Etapa 2: Conectar o SQL Workbench/J ao MaxCompute

Configure os parâmetros de conexão para vincular o SQL Workbench/J ao seu projeto MaxCompute.
Etapa 3: Gerenciar seu projeto MaxCompute usando o SQL Workbench/J

Use a conexão de dados estabelecida no SQL Workbench/J para gerenciar seu projeto MaxCompute.

Etapa 1: Criar um driver

Inicie o SQL Workbench e abra a interface da ferramenta.

Ao abrir a interface do SQL Workbench, a caixa de diálogo Select Connection Profile aparece automaticamente.
No canto inferior esquerdo da caixa de diálogo Select Connection Profile, clique em Manage Drivers. Crie um novo driver, insira um nome personalizado, faça upload do arquivo JAR do driver JDBC do MaxCompute e clique em OK para concluir a configuração.

Após o upload do driver JDBC do MaxCompute, o campo Classname é definido automaticamente como com.aliyun.odps.jdbc.OdpsDriver.

Etapa 2: Conectar o SQL Workbench/J ao MaxCompute

No painel de configuração Profile, no lado direito da caixa de diálogo Select Connection Profile, insira um nome para a conexão (por exemplo, MCtoSQL) e configure os parâmetros listados na tabela a seguir.

Parâmetro	Descrição
Driver	Driver usado para conectar ao seu projeto MaxCompute — o driver do MaxCompute (com.aliyun.odps.jdbc.OdpsDriver) criado na Etapa 1.
URL	URL para conexão ao seu projeto MaxCompute. Use o formato `jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true\|false}]`. Remova os símbolos `<>` durante a configuração. Os parâmetros são descritos abaixo: <MaxCompute_endpoint>: Obrigatório. Endpoint da região onde seu projeto MaxCompute está localizado. Para obter uma lista de endpoints, consulte Endpoints. <MaxCompute_project_name>: Obrigatório. Nome do projeto MaxCompute de destino. Este é o nome do seu projeto MaxCompute, não de um workspace. Faça login no MaxCompute console, alterne a região no canto superior esquerdo e localize o nome do projeto na página Projects. interactiveMode: Opcional. Especifica se o recurso Query Acceleration deve ser ativado. Para ativar o Query Acceleration, anexe `&interactiveMode=true` à URL. Para mais informações, consulte Query Acceleration.
Username	AccessKey ID com privilégios de acesso ao projeto MaxCompute de destino. Obtenha seu AccessKey ID na página AccessKey Management.
Password	AccessKey secret correspondente ao AccessKey ID. Obtenha seu AccessKey secret na página AccessKey Management.

Clique em Test. Após estabelecer a conexão com sucesso, clique em OK para criar a conexão de dados entre o SQL Workbench/J e o MaxCompute.

Etapa 3: Gerenciar seu projeto MaxCompute usando o SQL Workbench/J

Na interface do SQL Workbench/J, use a conexão de dados recém-criada para gerenciar seu projeto MaxCompute executando comandos MaxCompute SQL.

Visualize todas as tabelas

Após criar a conexão de dados, o SQL Workbench/J muda automaticamente para a interface de execução SQL. Execute o comando show tables; para listar todas as tabelas.

Insira sua instrução SQL na área Statement e clique em Run (▶) na barra de ferramentas para executá-la. Os resultados aparecem na aba Result abaixo.
Visualize o esquema de uma tabela

Uma vez criada a conexão de dados, o SQL Workbench/J exibe automaticamente a interface de execução SQL. Execute o comando desc <table_name>; para visualizar o esquema da tabela.
Visualize dados da tabela

Com a conexão de dados estabelecida, o SQL Workbench/J abre automaticamente a interface de execução SQL. Execute uma consulta SELECT para visualizar os dados da tabela.

Digite uma instrução SQL na área Statement — por exemplo, select * from bank_data_pt where age=35; — e clique em Execute na barra de ferramentas. Os resultados da consulta aparecem em uma tabela na aba Result abaixo.