O Hologres é compatível com o ecossistema PostgreSQL, permitindo a conexão por meio da maioria das ferramentas de desenvolvimento ou business intelligence (BI) que suportam esse banco de dados. Utilize suas ferramentas preferidas para construir rapidamente um data warehouse em tempo real de nível empresarial. Este tópico descreve como se conectar a uma instância do Hologres com um cliente PostgreSQL e usar instruções padrão para desenvolver dados.
Instale o cliente PSQL
Antes de usar um cliente PostgreSQL, baixe-o e instale-o no site oficial. Se o cliente já estiver instalado, ignore esta seção.
-
Baixe o cliente PostgreSQL
Acesse o site oficial do PostgreSQL para baixar o instalador da versão 11 ou superior do PostgreSQL correspondente ao seu sistema operacional. Em seguida, siga as instruções na tela para concluir a instalação.
-
Defina as variáveis de ambiente
-
No Windows:
Na janela , clique em Environment Variables.
Adicione o caminho do diretório
bindo PostgreSQL à variável Path. Na seção System variables, localize e selecione a variável Path e clique em Edit....Clique em OK.
No macOS, geralmente não é necessário definir variáveis de ambiente. Se precisar, consulte Set Up Environment Variables.
-
Conectar ao Hologres e desenvolver dados
Após instalar o cliente PostgreSQL, conecte-se à sua instância do Hologres e inicie o desenvolvimento de dados.
-
Conecte-se à instância do Hologres
Abra a interface de linha de comando do cliente PostgreSQL e insira as informações de conexão. A sintaxe é idêntica à usada para conectar-se a um banco de dados PostgreSQL padrão.
-
No Linux, execute o seguinte comando:
psql -h <Endpoint> -p <Port> -U <AccessKey ID> -d <Database>Quando solicitado, insira seu AccessKey Secret.
[postgres@iZj6cclqj7ttfq2f8stlgpZ ~]$ [postgres@iZj6cclqj7ttfq2f8stlgpZ ~]$ [postgres@iZj6cclqj7ttfq2f8stlgpZ ~]$ psql -h xxx-xxx-xxx-xxx.hologres.aliyuncs.com -p 80 -U LTAIxxx-xxx -d testdb Password for user xxx: psql (12.3, server 11.3) Type "help" for help. testdb=> testdb=> testdb=> testdb=> testdb=> -
No macOS, execute o seguinte comando:
PGUSER=<AccessKey ID> PGPASSWORD=<AccessKey Secret> psql -p <Port> -h <Endpoint> -d <Database>PGUSER=xxx PGPASSWORD=xxx psql -p 80 -h xxx.hologres.aliyuncs.com -d mydb psql (11.4, server 11.3) Type "help" for help. mydb=# -
No Windows, o cliente solicita os detalhes de conexão interativamente:
Server [localhost]: Endpoint Database [postgres]: Database Port [5432]: Port Username [postgres]: <AccessKey ID> Password for user <AccessKey ID>: <AccessKey Secret>Server [localhost]: Endpoint Database [postgres]: Database Port [5432]: 80 Username [postgres]: <AccessKey ID> Password for user <AccessKey ID>: psql (11.8, server 11.3) Type "help" for help. postgres=#
Parâmetro
Descrição
AccessKey ID
-
Conta Alibaba Cloud: AccessKey ID da sua conta Alibaba Cloud. Obtenha o AccessKey ID na página AccessKey Management.
-
Conta personalizada: nome de usuário da conta personalizada. Exemplo:
BASIC$abc.
AccessKey Secret
-
Conta Alibaba Cloud: AccessKey Secret da sua conta Alibaba Cloud.
-
Conta personalizada: senha da conta personalizada.
Port
Porta de rede pública ou de Virtual Private Cloud (VPC) da instância do Hologres.
Exemplo:
80.NotaPara mais informações sobre o endpoint público, consulte Instance Details.
Endpoint
Endpoint de rede pública ou de Virtual Private Cloud (VPC) da instância do Hologres.
Exemplo:
xxx-cn-hangzhou.hologres.aliyuncs.com.NotaPara mais informações sobre o endpoint público, consulte Instance Details.
Database
Nome do banco de dados do Hologres.
Ao criar uma instância do Hologres, o sistema cria automaticamente um banco de dados chamado postgres.
Use o banco de dados postgres para se conectar ao Hologres. No entanto, como esse banco possui recursos limitados, recomendamos criar um novo banco de dados para cargas de trabalho de produção. Para mais informações, consulte Criar um banco de dados.
Exemplo:
mydb.Exemplos:
-
Login com conta Alibaba Cloud:
PGUSER="xxx" PGPASSWORD="xxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demoPGUSER="LTAIxxx" PGPASSWORD="xT6qxxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demo psql (14.2, server 11.3) Type "help" for help. demo=# -
Login com conta personalizada:
-
Se o nome de usuário personalizado for
abc, crie-o no HoloWeb. Na barra de navegação superior, escolha security center. No painel de navegação à esquerda, clique em user management. Após selecionar a instância desejada, visualize a lista de usuários, que inclui membros, contas na nuvem, tipos de conta e tipos de função. No canto superior direito, clique em Create Custom User para adicionar uma conta BASIC. O nome da conta deve seguir o formatoBASIC$<user_name>, e o tipo de função será definido como SuperUser por padrão após a criação. -
Execute o seguinte comando para fazer login:
PGUSER="BASIC\$abc" PGPASSWORD="xxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demoPGUSER="BASIC\$abc" PGPASSWORD="1xxx" psql -h hgpostcn-cn-xxx-cn-hangzhou.hologres.aliyuncs.com -p 80 -d demo psql (14.2, server 11.3) Type "help" for help. demo=#
-
NotaVocê também pode usar outras ferramentas de desenvolvimento de sua preferência para se conectar ao Hologres, como DataWorks ou HoloWeb. Para mais informações, consulte Introdução ao DataWorks ou Conectar ao HoloWeb e executar consultas.
-
-
(Opcional) Crie um banco de dados
Ao criar uma instância do Hologres, o sistema gera automaticamente um banco de dados chamado postgres. Esse banco possui recursos limitados e destina-se apenas a tarefas operacionais e de gerenciamento. Para cargas de trabalho de desenvolvimento e produção, recomendamos criar um novo banco de dados.
NotaSe você já criou um banco de dados para seus negócios, pule esta etapa.
-
Sintaxe:
CREATE Database <DatabaseName>;DatabaseName é o nome do banco de dados a ser criado.
-
Exemplo:
-- Create a database named test. CREATE Database test;
-
-
Desenvolva dados
Use instruções padrão do PostgreSQL no cliente PostgreSQL para desenvolver dados.
O exemplo a seguir mostra como criar uma tabela no banco de dados e inserir dados nela:
BEGIN; CREATE TABLE nation ( n_nationkey bigint NOT NULL, n_name text NOT NULL, n_regionkey bigint NOT NULL, n_comment text NOT NULL, PRIMARY KEY (n_nationkey) ); CALL SET_TABLE_PROPERTY('nation', 'bitmap_columns', 'n_nationkey,n_name,n_regionkey'); CALL SET_TABLE_PROPERTY('nation', 'dictionary_encoding_columns', 'n_name,n_comment'); CALL SET_TABLE_PROPERTY('nation', 'time_to_live_in_seconds', '31536000'); COMMIT; INSERT INTO nation VALUES (11,'zRAQ', 4,'nic deposits boost atop the quickly final requests? quickly regula'), (22,'RUSSIA', 3 ,'requests against the platelets use never according to the quickly regular pint'), (2,'BRAZIL', 1 ,'y alongside of the pending deposits. carefully special packages are about the ironic forges. slyly special '), (5,'ETHIOPIA', 0 ,'ven packages wake quickly. regu'), (9,'INDONESIA', 2 ,'slyly express asymptotes. regular deposits haggle slyly. carefully ironic hockey players sleep blithely. carefull'), (14,'KENYA', 0 ,'pending excuses haggle furiously deposits. pending, express pinto beans wake fluffily past t'), (3,'CANADA', 1 ,'eas hang ironic, silent packages. slyly regular packages are furiously over the tithes. fluffily bold'), (4,'EGYPT', 4 ,'y above the carefully unusual theodolites. final dugouts are quickly across the furiously regular d'), (7,'GERMANY', 3 ,'l platelets. regular accounts x-ray: unusual, regular acco'), (20 ,'SAUDI ARABIA', 4 ,'ts. silent requests haggle. closely express packages sleep across the blithely'); SELECT * FROM nation;Desenvolva jobs conforme o seu caso de uso. Exemplos:
Acelerar consultas em dados do MaxCompute. Para mais informações, consulte Acelerar consultas do MaxCompute usando uma tabela externa.
Gravar dados no Hologres em tempo real usando Flink. Para detalhes, consulte Hologres sink.