Hologres es compatible con el ecosistema de PostgreSQL. Esto le permite conectarse a Hologres con la mayoría de las herramientas de desarrollo o de inteligencia empresarial (BI) que admiten PostgreSQL. Puede usar sus herramientas preferidas para construir rápidamente un almacén de datos en tiempo real de nivel empresarial. En este tema se describe cómo conectarse a una instancia de Hologres mediante un cliente de PostgreSQL y utilizar comandos estándar de PostgreSQL para desarrollar datos.
Instalar el cliente PSQL
Antes de usar un cliente de PostgreSQL, debe descargarlo e instalarlo desde el sitio web oficial. Si ya instaló el cliente, omita esta sección.
-
Descargue el cliente de PostgreSQL
Vaya al sitio web oficial de PostgreSQL para descargar el instalador de PostgreSQL versión 11 o posterior que corresponda a su sistema operativo. Después, siga las instrucciones en pantalla para completar la instalación.
-
Establezca las variables de entorno
-
Para Windows:
En la ventana , haga clic en Environment Variables.
Agregue la ruta del directorio
binde PostgreSQL a la variable Path. En la sección System variables, busque y seleccione la variable Path y, después, haga clic en Edit....Haga clic en OK.
En macOS, por lo general no es necesario establecer variables de entorno. Si lo requiere, consulte Set Up Environment Variables.
-
Conectarse a Hologres y desarrollar datos
Una vez instalado el cliente de PostgreSQL, puede conectarse a su instancia de Hologres y comenzar a desarrollar datos.
-
Conéctese a la instancia de Hologres
Abra la interfaz de línea de comandos del cliente de PostgreSQL e introduzca la información de conexión. La sintaxis es la misma que se usa para conectarse a una base de datos estándar de PostgreSQL.
-
En Linux, ejecute el siguiente comando.
psql -h <Endpoint> -p <Port> -U <AccessKey ID> -d <Database>Cuando el sistema lo solicite, introduzca su 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=> -
En macOS, ejecute el siguiente 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=# -
En Windows, el cliente le solicita los detalles de conexión de forma interactiva.
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
Descripción
AccessKey ID
-
Cuenta de Alibaba Cloud: el AccessKey ID de su cuenta de Alibaba Cloud. Puede obtener el AccessKey ID en la página AccessKey Management.
-
Cuenta personalizada: el nombre de usuario de la cuenta personalizada. Ejemplo:
BASIC$abc.
AccessKey Secret
-
Cuenta de Alibaba Cloud: el AccessKey Secret de su cuenta de Alibaba Cloud.
-
Cuenta personalizada: la contraseña de la cuenta personalizada.
Port
El puerto de red pública o de virtual private cloud (VPC) de la instancia de Hologres.
Ejemplo:
80.NotaPara más información sobre el endpoint público, consulte Instance Details.
Endpoint
El endpoint de red pública o de virtual private cloud (VPC) de la instancia de Hologres.
Ejemplo:
xxx-cn-hangzhou.hologres.aliyuncs.com.NotaPara más información sobre el endpoint público, consulte Instance Details.
Database
El nombre de la base de datos de Hologres.
Después de crear una instancia de Hologres, se crea automáticamente una base de datos llamada postgres.
Puede usar la base de datos postgres para conectarse a Hologres. Sin embargo, esta base de datos tiene recursos limitados. Para cargas de trabajo de producción, se recomienda crear una base de datos nueva. Para más información, consulte Create a database.
Ejemplo:
mydb.Ejemplos
-
Inicie sesión con una cuenta de 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=# -
Inicie sesión con una cuenta personalizada:
-
Si el nombre de usuario personalizado es
abc, puede crearlo en HoloWeb. En la barra de navegación superior, elija security center. En el panel de navegación izquierdo, haga clic en user management. Una vez seleccionada la instancia de destino, podrá consultar la lista de usuarios. Esta lista incluye miembros, cuentas en la nube, tipos de cuenta y tipos de rol. En la esquina superior derecha, haga clic en Create Custom User para agregar una cuenta BASIC. El nombre de la cuenta debe tener el formatoBASIC$<user_name>y, tras su creación, el tipo de rol será SuperUser de manera predeterminada. -
Ejecute el siguiente comando para iniciar sesión:
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=#
-
NotaTambién puede usar otras herramientas de desarrollo con las que esté familiarizado para conectarse a Hologres, como DataWorks o HoloWeb. Para más información, consulte Get started with DataWorks o Connect to HoloWeb and run queries.
-
-
(Opcional) Cree una base de datos
Después de crear una instancia de Hologres, se crea automáticamente una base de datos llamada postgres. Esta base de datos tiene recursos limitados y está diseñada únicamente para tareas operativas y de gestión. Para cargas de trabajo de desarrollo y producción, se recomienda crear una base de datos nueva.
NotaSi ya creó una base de datos para su negocio, omita este paso.
-
Sintaxis:
CREATE Database <DatabaseName>;DatabaseName es el nombre de la base de datos que desea crear.
-
Ejemplo:
-- Create a database named test. CREATE Database test;
-
-
Desarrolle datos
Utilice comandos estándar de PostgreSQL en el cliente de PostgreSQL para desarrollar datos.
A continuación se muestra un ejemplo de cómo crear una tabla en la base de datos e insertarle datos:
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;Puede desarrollar trabajos según su caso de uso. A continuación se presentan algunos ejemplos:
Acelere las consultas sobre datos de MaxCompute. Para más información, consulte Accelerate MaxCompute queries by using a foreign table.
Escriba datos en Hologres en tiempo real mediante Flink. Para más detalles, consulte Hologres sink.