Tablestore:Uso de Tablestore con PrestoDB

Paso 1: Conectar PrestoDB a Tablestore

Después de instalar PrestoDB, configure el catálogo y el esquema de PrestoDB para conectarse a Tablestore. El archivo de configuración del catálogo se encuentra en etc/catalog/tablestore.properties.

Paso 2: Ejecutar la CLI SQL de Presto

Una vez establecida la conexión, inicie Presto Server y ejecute las instrucciones SQL.

1. Obtenga el archivo ejecutable del cliente.

   1. Descargue el cliente de PrestoDB.

      Este tema utiliza presto-cli-0.280-executable.jar como ejemplo.

   2. Guarde el cliente de PrestoDB en el directorio bin de la carpeta de instalación de PrestoDB.

   3. En el directorio bin de la carpeta de instalación de PrestoDB, ejecute el siguiente comando para obtener el archivo ejecutable del cliente.

      # Rename the PrestoDB client file to presto. Replace presto-cli-0.280-executable.jar with the name of your client version.
      mv presto-cli-0.280-executable.jar presto
      # Grant the user permissions to operate the presto file.
      chmod +x presto

2. En el directorio bin de la carpeta de instalación de PrestoDB, ejecute el comando para iniciar Presto Server.

   Importante

   Al iniciar Presto Server, debe arrancar el coordinador y como mínimo un worker.

   # You can start the server in the foreground or background. The foreground mode is more convenient for viewing operational logs.
   # Method 1: Run in the background
   ./launcher start
   # Method 2: Run in the foreground
   ./launcher run

3. En el directorio bin de la carpeta de instalación de PrestoDB, ejecute el siguiente comando para iniciar la CLI SQL.

   Nota

   • De forma predeterminada, PrestoDB se ejecuta en el puerto 8080. Para cambiarlo, modifique el ajuste http-server.http.port en el archivo etc/config.properties.

   • Después de modificar los ajustes de configuración, reinicie el servidor para que los cambios surtan efecto.

   • En el comando, ./presto es la ruta relativa del archivo ejecutable del cliente dentro del directorio bin de la carpeta de instalación de PrestoDB.

   ./presto --server localhost:8080 --catalog tablestore --schema default

   A continuación se describen los elementos de configuración.

   Elemento de configuración	Ejemplo	Obligatorio	Descripción
   --server	localhost:8080	Sí	URI de Presto Server. Sustituya el valor según sea necesario. Este ajuste debe coincidir con el parámetro discovery.uri del archivo etc/config.properties ubicado en el directorio de instalación de PrestoDB.
   --catalog	tablestore	Sí	Nombre del archivo de configuración del catálogo. Establézcalo en tablestore, igual que el nombre del archivo de configuración del catálogo creado.
   --schema	default	Sí	Configuración del esquema. Mantenga el valor predeterminado.

Paso 3: Crear un esquema y una tabla de asignación

Cuando utilice el modo de configuración dinámica de esquema con una tabla de metadatos, cree manualmente un esquema para configurar la instancia de Tablestore conectada y llevar a cabo la autenticación de usuarios. Después, cree una tabla de asignación para la tabla de Tablestore con el fin de consultar y analizar datos.

1. Ejecute el siguiente comando para crear un esquema.

   El siguiente ejemplo muestra cómo crear un esquema llamado testdb para acceder a la instancia de Tablestore myinstance.

   CREATE SCHEMA tablestore.testdb
   WITH (
     endpoint = 'https://myinstance.cn-hangzhou.ots.aliyuncs.com',
     instance_name = 'myinstance',
     access_id = '************************',
     access_key = '********************************'
   );

   En la siguiente tabla se describen los parámetros.

   Parámetro	Ejemplo	Obligatorio	Descripción
   endpoint	https://myinstance.cn-hangzhou.ots.aliyuncs.com	Sí	Endpoint de la instancia de Tablestore. Para obtener más información, consulte Endpoints.
   instance_name	myinstance	Sí	Nombre de la instancia de Tablestore. Para obtener más información, consulte Instances.
   access_id		Sí	AccessKey ID de la cuenta de Alibaba Cloud o del usuario de RAM.
   access_key		Sí	AccessKey secret de la cuenta de Alibaba Cloud o del usuario de RAM.

2. Ejecute el comando use <SCHEMA_NAME>; para utilizar el esquema que creó.

   Sustituya <SCHEMA_NAME> por el nombre del esquema creado. Ejecute el comando show schemas; para obtener la lista de esquemas.

3. Ejecute el siguiente comando para crear una tabla de asignación para la tabla de datos de Tablestore.

   Importante

   Tenga en cuenta lo siguiente al crear una tabla de asignación:

   • Compruebe que los tipos de campo de la tabla de asignación coincidan con los de la tabla de datos de Tablestore. Para obtener más información, consulte Field type mapping.

   • El nombre de la tabla de asignación debe coincidir con el nombre de la tabla en Tablestore.

   • La propiedad table_name de la instrucción CREATE TABLE asigna la tabla de PrestoDB a la tabla real en Tablestore. Varias tablas de asignación con nombres distintos pueden apuntar a la misma tabla de datos de Tablestore.

   • La tabla de asignación debe incluir todas las columnas de clave principal de la tabla de datos, pero puede contener solo un subconjunto de las columnas de atributos.

   • Los nombres y el orden de las columnas de clave principal en la tabla de asignación deben coincidir con los de la tabla de datos de Tablestore. Asigne cada columna de atributos a su equivalente en Tablestore mediante el parámetro origin_name.

   Suponga que la tabla de datos se llama main_table e incluye dos columnas de clave principal, gid y uid, además de tres columnas de atributos: col1, col2 y col3.

   El siguiente ejemplo de SQL crea una tabla de asignación con el mismo nombre para la tabla de datos main_table de Tablestore.

   CREATE TABLE if not exists main_table
   (
      gid bigint,
      uid bigint,
      c1 boolean with (origin_name = 'col1'),
      c2 bigint with (origin_name = 'col2'),
      c3 varchar with (origin_name = 'col3')
   ) WITH (
      table_name = 'main_table'
   );

Paso 4: Usar SQL para operar con datos

Mediante instrucciones SQL puede consultar las configuraciones de esquema y los metadatos de las tablas, así como leer y escribir datos en las tablas de Tablestore. Para ver más ejemplos de SQL, consulte Common SQL examples.

1. Consultar las configuraciones de esquema.

   • Obtener la lista de esquemas

     show schemas;

   • Obtener la lista de tablas de un esquema específico

     show tables;

2. Consultar los metadatos de una tabla específica

   Sustituya <TABLE_NAME> por el nombre real de la tabla.

   describe <TABLE_NAME>;

3. Operaciones con datos.

   Lea y escriba datos de Tablestore.

   • Escribir datos

     • Insertar una fila de datos

       El siguiente ejemplo inserta una fila de datos en main_table.

       insert into main_table values(10001,10001,true,100,'hangzhou');

     • Importar datos por lotes

       Importante

       Antes de importar datos por lotes, compruebe que la tabla de destino esté creada y que su esquema coincida con el de la tabla de datos de origen.

       El siguiente ejemplo importa los datos de las columnas gid, uid, c1, c2 y c3 de main_table hacia sampletable, donde gid es mayor que 0 y uid es menor que 10,000.

       insert into sampletable select gid, uid, c1, c2, c3 from main_table where gid > 0 and uid < 100000;

   • Leer datos

     El siguiente ejemplo consulta las filas de sampletable donde el valor de la columna gid es mayor que 0, el valor de la columna uid es menor que 10 y c1 es true.

     select * from sampletable where gid > 0 and uid < 10 and c1 = true;