AnalyticDB:psql

Requisitos previos

• Obtenga el endpoint interno o público de la instancia de AnalyticDB for PostgreSQL.

  • Si su cliente se despliega en una instancia de Elastic Compute Service (ECS) ubicada en la misma región y con el mismo tipo de red que la instancia de AnalyticDB for PostgreSQL, utilice el endpoint interno para conectarse a la instancia de AnalyticDB for PostgreSQL. Inicie sesión en la consola de AnalyticDB for PostgreSQL. En la sección Database Connection Information de la página Basic Information, consulte el internal endpoint de la instancia.

  • Si su cliente se despliega en una instancia de ECS ubicada en otra región, utiliza un tipo de red distinto al de su instancia de AnalyticDB for PostgreSQL o se encuentra en un sistema externo a Alibaba Cloud, solicite primero un endpoint público. Después, use ese endpoint público para conectarse a la instancia de AnalyticDB for PostgreSQL. Para más información sobre cómo solicitar un endpoint público, consulte Manage public endpoints.

• Agregue la dirección IP de su cliente a una lista blanca de direcciones IP de la instancia de AnalyticDB for PostgreSQL. Para más información, consulte Configure an IP address whitelist.

Descarga e instalación de psql

1. Para Red Hat Enterprise Linux (RHEL) 6 o 7 y CentOS 6 o 7, descargue el paquete de instalación de psql desde los siguientes enlaces.

   Versión del motor	Versión del sistema operativo	Enlace de descarga
   AnalyticDB for PostgreSQL V7.0	RHEL 7 o CentOS 7	adbpg7_client_package.el7.x86_64.tar.gz
   AnalyticDB for PostgreSQL V6.0	RHEL 7 o CentOS 7	ADBPG_client_package_el7
   	RHEL 6 o CentOS 6	ADBPG_client_package_el6

2. Una vez descargado el paquete de instalación, descomprímalo e instale la herramienta. Siga estos pasos:

   1. Ejecute el siguiente comando para descomprimir el paquete de instalación dentro del directorio donde se encuentra:

      tar -xzvf <Name of the installation package>

      Comando de ejemplo:

      tar -xzvf adbpg_client_package.el7.x86_64.tar.gz

   2. Ejecute el siguiente comando para cambiar al directorio bin:

      cd adbpg_client_package/bin

   3. El directorio bin incluye herramientas de cliente como psql y pg_dump. Ejecute los comandos correspondientes según la documentación de referencia de cada herramienta.

      • Para más información sobre cómo conectarse a una instancia mediante psql, consulte la sección "Connect to an instance" de este tema.

      • pg_dump es una herramienta de copia de seguridad lógica para PostgreSQL. Para más información sobre su uso, consulte pg_dump.

Conexión a una instancia

1. Utilice uno de los siguientes métodos para conectarse a una instancia:

   • Cadena de conexión

     psql "host=yourgpdbaddress.gpdb.rds.aliyuncs.com port=5432 dbname=postgres user=gpdbaccount password=gpdbpassword"

   • Parámetros específicos

     psql  -h yourgpdbaddress.gpdb.rds.aliyuncs.com -p 5432 -d postgres -U gpdbaccount

     Parámetros:

     • -h: el endpoint que se usa para conectarse a la instancia.

     • -p: el número de puerto que se usa para conectarse a la instancia.

     • -d: el nombre de la base de datos. El valor predeterminado es postgres.

     • -U: la cuenta de la base de datos que se usa para conectarse a la instancia.

     Nota

     Ejecute el comando psql --help para consultar más opciones. También puede ejecutar el comando \? para ver otros comandos compatibles con psql.

2. Introduzca la contraseña para acceder a la CLI de psql.

Además, puede utilizar la caja de herramientas de Docker en AnalyticDB for PostgreSQL, como se muestra en el siguiente código de ejemplo. Para más información sobre cómo instalar Docker, visite el sitio web oficial de Docker.

Ejecute la imagen de la herramienta correspondiente a AnalyticDB for PostgreSQL V6.0.

docker run -idt --name=adbpgcli aliadbpg/adbpgcli:v6.3.0
docker exec -it adbpgcli /bin/bash -l

Referencias

• Para más información sobre cómo usar psql en Greenplum, consulte Greenplum psql.

• También puede usar psql en PostgreSQL. Tome en cuenta las diferencias entre los comandos de psql de Greenplum y los de PostgreSQL. Para más información, consulte PostgreSQL psql.

• Si aparece el error could not connect to server xxx, consulte What do I do if I cannot connect to an instance? para resolver el problema.