Hologres:Connect and query with HoloWeb

Pré-requisitos

Uma instância do Hologres está ativada. Purchase a Hologres instance.

Procedimento

1. Faça login no Hologres Management Console.

2. No painel de navegação à esquerda da barra de menu superior, selecione a região desejada.

3. Clique em Go to HoloWeb para abrir a página de desenvolvimento do HoloWeb.

4. Conecte-se a uma instância do Hologres.

   1. Na aba Metadata Management, clique em Instances.

   2. Na caixa de diálogo Instances, configure os parâmetros e clique em OK.

      Parâmetro	Descrição	Obrigatório
      Network type	Selecione Public Network ou VPC. Public Network está disponível em: China (Shanghai), China (Shenzhen), China (Beijing), China (Hangzhou), China (Zhangjiakou), Singapore, China (Hong Kong), Malaysia (Kuala Lumpur), Indonesia (Jakarta) e US (Silicon Valley). VPC está disponível apenas na região em que o HoloWeb está conectado no momento; conexões de instâncias VPC não podem ser editadas nem excluídas.	Não
      Instance name	Selecione uma instância criada na sua conta atual. Caso a instância não apareça, o HoloWeb pode ainda estar carregando — insira o Domain Name e a Port manualmente para continuar.	Não
      Name	O nome de exibição desta conexão. O padrão é o nome da instância selecionada, mas você pode personalizá-lo.	Sim
      Description	Uma descrição opcional para esta conexão.	Não
      Domain name	O endpoint de rede da sua instância do Hologres. Ao selecionar um Instance name, este campo é preenchido automaticamente. Você também pode inseri-lo manualmente a partir da seção Network Information na página de detalhes da instância.	Sim
      Port	A porta de rede da sua instância do Hologres. Ao selecionar um Instance name, este campo é preenchido automaticamente. Você também pode inseri-lo manualmente em Network Information.	Sim
      Logon method	Password-free Logon autentica usando sua conta Alibaba Cloud atual — sem necessidade de credenciais. Escolha esta opção ao conectar com a mesma conta usada para acessar o Management Console. Password Logon permite entrar com o AccessKey ID e o AccessKey secret da sua conta atual ou de outra conta. Escolha esta opção quando precisar conectar como uma conta diferente.	Sim
      Username	O AccessKey ID da conta. Obrigatório apenas para Password Logon.	Não
      Password	O AccessKey secret da conta. Obrigatório apenas para Password Logon.	Não
      Test connectivity	Clique para verificar a conexão antes de salvar. The test is successful. confirma que a conexão é válida. Se The test failed. aparecer, verifique o nome de domínio, a porta e as credenciais.	Não
      Log on after connecting	Yes: a instância aparece na lista de instâncias conectadas à esquerda. No: a instância é salva, mas não conectada, e aparece na lista de instâncias não conectadas.	Sim

5. (Opcional) Crie um banco de dados.

   Cada instância do Hologres inclui um banco de dados postgres padrão com recursos limitados, destinado apenas a operações de gerenciamento.

   Nota

   Se você já criou um banco de dados, ignore esta etapa e crie uma consulta SQL.

   1. Clique em Metadata Management > Database.

      Como alternativa, na página Metadata Management, clique com o botão direito na sua instância na lista Instances Connected e selecione Create Database.

   2. Na caixa de diálogo Create Database, configure os parâmetros e clique em OK.

      Parâmetro	Descrição
      instance name	Exibe o nome da instância conectada por padrão.
      database name	Insira um nome para o banco de dados. Nota O nome do banco de dados deve ser único dentro da instância.
      permission policy	Selecione uma política de permissão para o banco de dados de acordo com suas necessidades de negócio. Para mais informações sobre políticas de permissão, consulte os tópicos a seguir: SPM SLPM standard PostgreSQL authorization model
      Log on	Yes: o login no banco de dados é feito automaticamente e você pode utilizá-lo imediatamente. No: é necessário fazer login manualmente no banco de dados antes de utilizá-lo.

6. Crie uma consulta SQL

   Use o SQL Editor para escrever e executar instruções PostgreSQL padrão.

   1. Na página SQL Editor, clique no ícone .

      Como alternativa, no painel de navegação à esquerda, clique com o botão direito em My SQL query e selecione Create SQL Query. SQL window.

   2. Na nova aba Ad-hoc Query, selecione uma instância na lista suspensa Instance Name e um banco de dados na lista suspensa Database. Insira as instruções a seguir no editor SQL e clique em Run.

      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;

      Nota

      As consultas SQL não diferenciam maiúsculas de minúsculas para nomes de tabelas e campos. Para realizar uma busca com distinção de maiúsculas e minúsculas em uma tabela, coloque o nome da tabela entre aspas duplas (").

   3. A seção Result [1] na parte inferior da página do SQL Editor exibe o resultado da execução.

      A consulta retorna 10 registros da tabela nation, incluindo as colunas n_nationkey, n_name, n_regionkey e n_comment, confirmando que a criação da tabela e a inserção dos dados foram realizadas com sucesso.

7. Crie uma tabela externa para acelerar consultas nos dados do MaxCompute.

   O Hologres se integra ao MaxCompute na camada de recursos, possibilitando a aceleração de consultas por meio de tabelas externas. Siga as etapas abaixo para criar uma tabela externa no HoloWeb.

   Nota

   • Verifique se você created a MaxCompute project, criou a tabela source e a preencheu com dados. Isso pode ser feito de uma das seguintes formas:

     1. Em DataWorks, vincule um data source do MaxCompute e, em seguida, crie uma tabela e preencha-a com dados.

     2. Use o cliente do MaxCompute para criar uma tabela e gravar dados nela. Use the MaxCompute client.

   • É necessário fazer login em um banco de dados no HoloWeb antes de utilizar os recursos de aceleração para data lakes do MaxCompute e OSS.

   1. Clique em Metadata Management > Import from MaxCompute > Create Foreign Table.

   2. Configure os parâmetros na caixa de diálogo Create Foreign Table, selecione um método de aceleração e clique em Submit.

      Entire project

      Categoria	Parâmetro	Descrição
      Acceleration Method	Select an acceleration method.	O Hologres oferece suporte a três métodos de aceleração: Entire Project Selected Tables Single Table Selecione Entire Project.
      MaxCompute Data Source	Project Name	O nome do projeto do MaxCompute.
      	Schema Name	O nome do schema do MaxCompute. Se o seu projeto do MaxCompute tiver schemas habilitados, especifique qualquer schema para o qual você tenha permissões. Este parâmetro não é obrigatório para projetos sem schemas. Schema operations.
      Destination Table Position	Holo schema	O nome do schema. Selecione o schema padrão public ou um schema personalizado que você criou.
      Advanced Settings	Processing Rule for Table Name Conflicts	Define como tratar conflitos de nome de tabela. Valores válidos: Ignore, and continue creating other tables Update, and modify the existing table Report an error, and do not create the table
      	Processing Rule for Unsupported Data Types	Define como tratar tipos de dados não suportados. Valores válidos: Report an error and fail the import Ignore and Skip Table of Unsupported Fields

      Selected tables

      Categoria	Parâmetro	Descrição
      Acceleration Method	Select an acceleration method.	O Hologres oferece suporte a três métodos de aceleração: Entire Project Selected Tables Single Table Selecione Selected Tables.
      MaxCompute Data Source	Project Name	O nome do projeto do MaxCompute.
      	Schema Name	O nome do schema do MaxCompute. Se o seu projeto do MaxCompute tiver schemas habilitados, especifique qualquer schema para o qual você tenha permissões. Este parâmetro não é obrigatório para projetos sem schemas. Schema operations.
      Destination Table Position	Holo schema	O nome do schema. Selecione o schema padrão public ou um schema personalizado que você criou.
      Advanced Settings	Processing Rule for Table Name Conflicts	Define como tratar conflitos de nome de tabela. Valores válidos: Ignore, and continue creating other tables Update, and modify the existing table Report an error, and do not create the table
      	Processing Rule for Unsupported Data Types	Define como tratar tipos de dados não suportados. Valores válidos: Report an error and fail the import Ignore and Skip Table of Unsupported Fields
      	Search	É possível realizar uma busca aproximada por nome de tabela. A pesquisa retorna no máximo 200 tabelas.

      Single table

      Categoria	Parâmetro	Descrição
      Acceleration Method	Select an acceleration method.	O Hologres oferece suporte a três métodos de aceleração: Entire Project Selected Tables Single Table Selecione Single Table.
      MaxCompute Data Source	Project Name	O nome do projeto do MaxCompute.
      	Schema Name	O nome do schema do MaxCompute. Se o seu projeto do MaxCompute tiver schemas habilitados, especifique qualquer schema para o qual você tenha permissões. Este parâmetro não é obrigatório para projetos sem schemas. Schema operations.
      	Table Name	Especifica a tabela source no schema do MaxCompute indicado. É possível usar um prefixo do nome da tabela para realizar uma busca aproximada.
      Destination Hologres Table	Schema	O nome do schema. Selecione o schema padrão public ou um schema personalizado que você criou.
      	Table Name	Especifica o nome da tabela do Hologres usada para aceleração de consultas.
      	Destination Table Description	Especifica a descrição da tabela do Hologres usada para aceleração de consultas.

   3. Após criar a tabela externa, acesse Metadata Management > Instances Connected no painel de navegação à esquerda. Localize a tabela externa e clique duas vezes sobre ela. Na aba do editor que se abrir, clique em Data Preview para verificar se é possível consultar os dados do MaxCompute.

Criar uma tabela interna pelo console