Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Visão geral de serviço
- O que é o GaussDB(DWS)?
- Tipos de Data Warehouse
- Especificações do armazém de dados
- Vantagens
- Cenários de aplicação
- Funções
- Conceitos
- Serviços relacionados
- Gerenciamento de permissões do GaussDB(DWS)
- Acesso ao GaussDB(DWS)
- Detalhes de preços
- Restrições
- Service Quotas
- Especificações técnicas
- Descrição da versão
Guia de gerenciamento
- Processo para usar o GaussDB(DWS)
- Preparativos
- Criação ou exclusão de um cluster
- Conexão de clusters
- Monitoramento e alarmes
- Mudança e dimensionamento de especificações
- Backup e recuperação de desastres
  - Snapshots
  - DR do cluster
- O&M inteligente
- Gerenciamento de cluster
- Migração de dados
- Gerenciamento de logs de cluster
- Gerenciamento de usuários de banco de dados
  - Gerenciamento de usuários
  - Gerenciamento de funções
- Logs de auditoria
- Gerenciamento de segurança de cluster
- Gerenciamento de recursos
- Gerenciamento de fonte de dados
  - Fontes de dados do MRS
  - Gerenciamento de fontes de dados do OBS
- Gerenciamento de clusters lógicos
Referência de API
- Antes de começar
- Visão geral de API
- Chamada das API
- Introdução
- Descrição de API
  - As API de gerenciamento de cluster
  - As API de gerenciamento de snapshot
- Casos de aplicação
  - Uso de Postman para chamar a API para criar um snapshot
- Políticas de permissões e ações suportadas
- Apêndice
Primeiros passos
- Passo 1: Preparação antes da entrada
- Passo 2: criação de um cluster
- Passo 3: conexão a um cluster
- Passo 4: Exibindo Outros Documentos e Compensando Recursos
Perguntas frequentes
- Perguntas frequentes principais
- Problemas gerais
- Uso do banco de dados
- Gerenciamento de clusters
- Conexões de banco de dados
- Importação e exportação de dados
- Conta, senha e permissão
- Desempenho do banco de dados
- Backup e restauração do snapshot
  1. Por que criar um snapshot automatizado é tão lento?
  2. Um snapshot de DWS tem a mesma função que um snapshot de EVS?
- Cobrança
Melhores práticas
- Importação e exportação
- Migração de dados
- Práticas da otimização de tabela
- Recursos avançados
- Gerenciamento de banco de dados
- Análise de dados de amostra
- Gerenciamento de segurança
No momento, o conteúdo não está disponível no seu idioma selecionado. Consulte a versão em inglês.
What's New
Function Overview
Product Bulletin
- Product Notice
- Version Support Notes
Billing
- GaussDB(DWS) Billing Overview
- Billing Modes
- Item
- Billing Examples
- Billing Mode Change
- Renewal
  - Overview
  - Manual Renewal
- Bills
- Arrears
- Stopping Billing
- Cost Management
- Billing FAQs
Data Migration and Synchronization
- Data Migration to GaussDB(DWS)
- Importing Data
- Full Database Migration
  - Using CDM to Migrate Data to GaussDB(DWS)
  - Using DSC to Migrate SQL Scripts
- Real-time Import
  - Using DRS to Import Data to GaussDB(DWS)
  - Real-time Data Import From Kafka GaussDB(DWS)
- Metadata Migration
  - Using gs_dump and gs_dumpall to Export Metadata
  - Using gs_restore to Import Data
- Exporting Data
- Other Operations
Developer Guide
- Standard data warehouse (9.1.0.x)
- Standard data warehouse (8.1.3.x)
- Hybrid Data Warehouse (9.1.0.x）
- Hybrid Data Warehouse (8.1.3.x）
- Historical Versions
SQL Syntax Reference
- SQL Syntax Reference (9.1.0.x)
- SQL Syntax Reference (8.1.3.x)
- Historical Versions
Performance Tuning
- Overview of Query Performance Optimization
- Query Execution Process
- SQL Execution Plan
- SQL Optimization Guide
- Optimization Cases
- SQL Execution Troubleshooting
- query_band Load Identification
- Common Performance Parameter Optimization Design
Tool Guide
- Overview
- Downloading Related Tools
- gsql
- Data Studio
- GDS
- DSC
- DataCheck
- DWS-Connector
- Server Tool
SDK Reference
- SDK Overview
Troubleshooting
- Database Connections
- JDBC/ODBC
- Data Import and Export
- Database Parameter Modification
- Account/Permission/Password
- Cluster Performance
- Cluster Exceptions
  - The Disk Usage Alarm Is Frequently Generated
- Database Use
Videos
Performance White Paper
- Overview
- Test Result
  - TPC-H Single Query Test
  - TPC-DS Single Query Test
- Test Methods
- Appendixes
  - TPC-H Test Sets
  - TPC-DS Test Sets
Technical White Paper
- GaussDB(DWS)
- Platforms and Technical Specifications Supported by GaussDB(DWS)
  - Technical Specifications
- GaussDB(DWS) Core Technologies
- GaussDB(DWS) Tools
  - Client Tools
  - Database Monitoring Tool
- External APIs
Error Code Reference
- 8.2.0 and earlier versions
  - Management Console Error Code
  - Data Warehouse Service Error Codes
- 8.2.1 or later versions
Glossary
More Documents
- User Guide
- API Reference (ME-Abu Dhabi Region)
- Developer Guide (ME-Abu Dhabi Region)
- SQL Syntax Reference (ME-Abu Dhabi Region)
- Tool Guide (ME-Abu Dhabi Region)
- Error Code Reference (ME-Abu Dhabi Region)
  - Management Console Error Code
- User Guide (Paris Region)
- API Reference (Paris Region)
- Developer Guide (Paris Region)
- SQL Syntax Reference (Paris Region)
- Tool Guide (Paris Region)
- Error Code Reference (Paris Region)
  - Management Console Error Code
- User Guide (Kuala Lumpur Region)
- API Reference (Kuala Lumpur Region)
- Developer Guide (Kuala Lumpur Region)
- SQL Syntax Reference (Kuala Lumpur Region)
- Tool Guide (Kuala Lumpur Region)
- Error Code Reference (Kuala Lumpur Region)
  - Management Console Error Code

Nesta página

Procedimento
Precauções
Referência de comandos gsql

Mostrar todos

Central de ajuda/ GaussDB(DWS)/ Guia de gerenciamento/ Conexão de clusters/ Uso do cliente de CLI gsql para conectar-se a um cluster/ Uso do cliente gsql de Windows para conectar-se a um cluster

Uso do cliente gsql de Windows para conectar-se a um cluster

Atualizado em 2025-01-22 GMT+08:00

Ver PDF

Esta seção descreve como se conectar a um banco de dados por meio de um cliente SQL depois de criar um cluster de armazém de dados e antes de usar o banco de dados do cluster. O GaussDB(DWS) fornece o cliente gsql de Windows que corresponde à versão do cluster para que você acesse o cluster por meio do endereço de rede público ou privado do cluster.

Procedimento

Instale e execute o cliente gsql no servidor Windows local (na CLI do Windows). O Windows Server 2008/Windows 7 e versões posteriores são suportados.
Baixe o cliente gsql do Windows consultando Baixa do cliente do Data Studio e descompactando o pacote em uma pasta local.

Figura 1 Pasta do cliente gsql do Windows
No servidor local, clique em Start, procure cmd e execute o programa como administrador. Como alternativa, pressione Win+R para abrir a CLI do Windows.
Defina variáveis de ambiente. Para um sistema operacional de 32 bits, selecione a pasta x86. Para um sistema operacional de 64 bits, selecione a pasta x64.

Método 1: configure variáveis de ambiente na CLI do Windows. Abra o prompt de comando e execute o comando set path=<window_gsql>;%path% command, where <window_gsql> indica o caminho da pasta onde o cliente gsql do Windows foi descompactado na etapa anterior. Por exemplo:
1

set path=C:\Users\xx\Desktop\dws_8.1.x_gsql_for_windows\x64;%path%
Método 2: na janela Control Panel, procure por System e clique em View advanced system settings. Clique na guia Advanced e clique em Environment Variables. Selecione o parâmetro Path e clique em Edit. Adicione o caminho gsql no valor do parâmetro. Por exemplo:

Figura 2 Configurar variáveis de ambiente do Windows
(Opcional) Para se conectar ao cluster no modo SSL, configure os parâmetros de autenticação SSL no servidor em que o cliente está instalado. Para mais detalhes, consulte Estabelecimento de conexões TCP/IP seguras no modo SSL.

O modo de conexão SSL é mais seguro do que o modo não SSL. É aconselhável ligar o cliente ao cluster no modo SSL.

Na CLI do Windows, execute o seguinte comando para se conectar ao banco de dados no cluster do GaussDB(DWS) usando o cliente gsql:

      
         gsql -d <Database_name> -h <Cluster_address> -U <Database_user> -p <Database_port> -W <Cluster_password> -r

Os parâmetros são os seguintes:

Database name: informe o nome do banco de dados a ser conectado. Se você usar o cliente para se conectar ao cluster pela primeira vez, insira o banco de dados gaussdb padrão.
Cluster address: para obter detalhes sobre como obter o endereço, consulte Obtenção do endereço de conexão do cluster. Se um endereço de rede pública for usado para conexão, defina esse parâmetro como o nome de domínio da rede pública. Se um endereço de rede privada for usado para conexão, defina esse parâmetro como o nome de domínio da rede privada. Se o ELB for usado para conexão, defina esse parâmetro como ELB Address. Se ELB for usado para conexão, defina esse parâmetro como o endereço do ELB.
Database user: informe o nome de usuário do banco de dados do cluster. Se você usar o cliente para se conectar ao cluster pela primeira vez, defina esse parâmetro como o administrador padrão configurado durante a criação do cluster, por exemplo, dbadmin.
Database port: insira o conjunto de portas do banco de dados durante a criação do cluster.

Por exemplo, execute o seguinte comando para se conectar ao banco de dados gaussdb padrão no cluster do GaussDB(DWS):

      
         gsql -d gaussdb -h 10.168.0.74 -U dbadmin -p 8000 -W password -r

Se as informações a seguir forem exibidas, a conexão foi bem-sucedida.

gaussdb=>

Precauções

A codificação de caracteres padrão do prompt de comando do Windows é GBK e o valor padrão de client_encoding do Windows gsql é GBK. Alguns caracteres codificados usando UTF-8 não podem ser exibidos em gsql do Windows.
Sugestão: Certifique-se de que o arquivo especificado usando -f usa codificação UTF-8 e defina o formato de codificação padrão para UTF-8 (set client_encoding='utf-8';).

Caminhos no gsql do Windows devem ser separados por barras (/), ou um erro será relatado. Em um meta-comando, a barra invertida (\) indica o início de um meta-comando. Se a barra invertida estiver entre aspas simples ('\'), ela será usada como escape.

      
         gaussdb=> \i D:\test.sql
D:: Permission denied
postgres=> \i D:/test.sql
id
----
  1
(1 row)

Para usar o metacomando \! para executar um comando do sistema no gsql do Windows, use o separador de caminho exigido pelo comando do sistema. Geralmente, o separador de caminho é uma barra invertida (\).

      
         gaussdb=> \! type D:/test.sql
Incorrect syntax.
gaussdb=> \! type D:\test.sql
select 1 as id;

O gsql do Windows não suporta o meta-comando \parallel.

      
         gaussdb=> \parallel
ERROR: "\parallel" is not supported in Windows.

No shell do Linux, aspas simples ('') e aspas duplas ("") podem ser usadas para delimitar cadeias. No Windows, apenas aspas duplas podem ser usadas.

      
         gsql -h 192.168.233.189 -p 8109 -d postgres -U odbcuser -W password -c "select 1 as id"
 id
----
  1
(1 row)

Se as aspas simples forem usadas, um erro será relatado e a entrada será ignorada.

       
          gsql -h 192.168.233.189 -p 8109 -d postgres -U odbcuser -W password -c 'select 1 as id'
gsql: warning: extra command-line argument "1" ignored
gsql: warning: extra command-line argument "as" ignored
gsql: warning: extra command-line argument "id'" ignored
ERROR:  unterminated quoted string at or near "'select"
LINE 1: 'select

Se o gsql do Windows estiver ocioso por um longo tempo após a conexão ser estabelecida, o tempo limite da sessão de conexão e um erro de SSL será relatado. Nesse caso, você precisa fazer logon novamente. O seguinte erro é relatado:

      
         SSL SYSCALL error: Software caused connection abort (0x00002745/10053), remote datanode <NULL>, error: Result too large

No Windows, pressione Ctrl+C para sair do gsql. Se Ctrl+C for pressionado durante a entrada, a entrada será ignorada e você será forçado a sair do gsql.
Digite as e pressione Ctrl+C. Depois que \q for exibido, saia do gsql.
1 2

gaussdb=> select 1 gaussdb=> as \q
O gsql do Windows não pode se conectar a um banco de dados usando a codificação de caracteres LATIN1. As informações de erro são as seguintes:
1

gsql: FATAL: conversion between GBK and LATIN1 is not supported

A localização do arquivo gsqlrc.conf:

O caminho padrão do gsqlrc é %APPDATA%/postgresql/gsqlrc.conf. Você também pode definir o caminho usando a variável PSQLRC.

       
          set PSQLRC=C:\Users\xx\Desktop\dws_8.1.x_gsql_for_windows\x64\gsqlrc.conf

Referência de comandos gsql

Para obter mais informações sobre os comandos gsql, consulte o Guia de ferramenta do Data Warehouse Service (DWS).

Tópico principal: Uso do cliente de CLI gsql para conectar-se a um cluster

Tópico anterior: Uso do cliente gsql de Linux para conectar-se a um cluster

Próximo tópico: Estabelecimento de conexões TCP/IP seguras no modo SSL

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar