Como conectar o DataGrip e gerenciar dados - MaxCompute: Central de Documentação do Alibaba Cloud

Contexto

O DataGrip é um ambiente de gerenciamento de banco de dados para desenvolvedores que simplifica consultas, criação e gestão de bancos de dados. Ele oferece suporte a bancos de dados locais, baseados em servidor e na nuvem. Para obter mais informações, consulte DataGrip.

Pré-requisitos

Certifique-se de atender aos seguintes requisitos:

Crie um projeto do MaxCompute.

Para obter mais informações, consulte Criar um projeto do MaxCompute.
Tenha um AccessKey ID e um AccessKey Secret com permissões para acessar o projeto do MaxCompute.

Acesse a página AccessKey Management para obter um AccessKey ID e um AccessKey Secret.
Baixe o pacote JAR do driver JDBC do MaxCompute com todas as dependências (jar-with-dependencies).

Baixe o driver clicando em odps-jdbc-3.9.0.jar, obtenha a versão mais recente no GitHub ou no repositório Maven. Este tópico usa o driver JDBC do MaxCompute v3.9.0 como exemplo.
Baixe e instale o DataGrip.

Para obter mais informações, consulte Instalar o DataGrip.

Este tópico utiliza o DataGrip 2024.3.3 como exemplo.

Procedimento

Para conectar o DataGrip ao MaxCompute, siga estas etapas:

Etapa 1: Adicionar um driver e configurar uma fonte de dados

Adicione o driver JDBC do MaxCompute ao DataGrip e configure os parâmetros de conexão do seu projeto do MaxCompute.
Etapa 2: Usar o DataGrip para gerenciar o projeto do MaxCompute

Use a conexão criada no DataGrip para gerenciar seu projeto do MaxCompute.

Etapa 1: Configurar o driver e a fonte de dados

Inicie o DataGrip.
No main menu, selecione File > Create > Project.
Na caixa de diálogo New Project, insira um nome para o projeto, como MaxCompute_test.
Na janela do novo projeto, clique em Create > Driver no canto superior esquerdo.
Na caixa de diálogo Data Sources and Drivers, acesse a aba Drivers. Clique no ícone e selecione User Driver. Nomeie o driver, por exemplo, MaxCompute.

Na seção Driver Files, clique no ícone e selecione Custom JARs. Selecione o arquivo JAR do driver JDBC do MaxCompute baixado em sua máquina local, como odps-jdbc-3.9.0-rc4-jar-with-dependencies.jar.

Parâmetro	Descrição
Name	Um nome para o novo driver, como MaxCompute.
Class	Após carregar o arquivo JAR do driver JDBC do MaxCompute, selecione com.aliyun.odps.jdbc.OdpsDriver na lista suspensa.

Acesse a aba Data Source. Clique no ícone e selecione o driver criado, como MaxCompute.

Na aba General, configure os seguintes parâmetros.

Parâmetro	Descrição
Name	O padrão é o nome do driver. Especifique um nome personalizado, se necessário.
Authentication	Selecione User & Password.
User	O AccessKey ID com permissões para acessar o projeto do MaxCompute. Acesse a página AccessKey Management para obter o AccessKey ID.
Password	O AccessKey Secret correspondente ao AccessKey ID.
URL	A URL de conexão para o projeto do MaxCompute. O formato é `jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true\|false}]`. Não inclua os sinais de menor e maior (`<>`) na URL. A tabela a seguir descreve os parâmetros. <MaxCompute_endpoint>: Obrigatório. O endpoint da região onde seu projeto do MaxCompute está localizado. Para obter uma lista de endpoints, consulte Endpoints. <MaxCompute_project_name>: Obrigatório. O nome do projeto do MaxCompute de destino. Este é o nome do seu projeto do MaxCompute, não de um workspace. Faça login no console do MaxCompute, 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 obter mais informações, consulte Query Acceleration. useProjectTimeZone: Opcional. Este parâmetro sincroniza o fuso horário entre o DataGrip e a instância do servidor MaxCompute. Para usar o mesmo fuso horário, anexe `&useProjectTimeZone=true` à URL.

Clique em Test Connection para verificar a configuração.
Clique em OK para salvar a configuração.

Etapa 2: Gerenciar o projeto

Após criar a conexão, a nova conexão do MaxCompute aparece no painel à esquerda. Escreva e execute scripts SQL para gerenciar seu projeto do MaxCompute. Para obter mais informações, consulte Ajuda do DataGrip.

Visualizar todas as tabelas

Visualize informações sobre todas as tabelas na sua conexão do MaxCompute.

No painel Database Explorer à esquerda, expanda Conexão MaxCompute > nome do projeto > default > tables para visualizar todas as tabelas no schema.
Visualizar o schema de uma tabela

Clique com o botão direito na tabela de destino, selecione Create > Query Console e escreva e execute um script SQL no editor SQL à direita para visualizar o schema da tabela.

Por exemplo, execute o comando DESC sale_detail. A saída lista as Native Columns, que incluem shop_name(STRING), customer_id(STRING) e total_price(DOUBLE), além das Partition Columns, que incluem sale_date(STRING) e region(STRING).
Visualizar dados da tabela

Clique com o botão direito na tabela de destino, selecione Create > Query Console e escreva e execute um script SQL no editor SQL à direita para visualizar os dados da tabela.

Por exemplo, para consultar a tabela pyodps_iris, execute o comando SELECT * FROM pyodps_iris;. Clique no ícone verde de triângulo Run na barra de ferramentas para visualizar os dados da tabela no painel Result na parte inferior.