Conexión de SQL Workbench/J a MaxCompute - MaxCompute - Centro de documentación de Alibaba Cloud

MaxCompute permite usar la herramienta de gestión de bases de datos SQL Workbench/J para acceder a su proyecto de MaxCompute y gestionar datos. Este tema describe cómo conectar SQL Workbench/J a un proyecto de MaxCompute mediante el controlador JDBC de MaxCompute y cómo administrar los datos.

Información de contexto

SQL Workbench/J es una herramienta gratuita y multiplataforma de consultas SQL que funciona de manera independiente a cualquier sistema de gestión de bases de datos (DBMS). Está escrita en Java y se ejecuta en cualquier sistema operativo que cuente con un entorno de ejecución de Java.

Requisitos previos

Antes de continuar, confirme que cumple con los siguientes requisitos:

Ha creado un proyecto de MaxCompute.

Para obtener más información sobre cómo crear un proyecto de MaxCompute, consulte Create a MaxCompute project.
Ha obtenido un AccessKey ID y un AccessKey secret con permisos de acceso al proyecto de MaxCompute.

Puede obtener su AccessKey ID y su AccessKey secret en la página de Gestión de AccessKey.
Ha descargado el controlador JDBC de MaxCompute (versión 3.0.1 o posterior) que incluye el paquete JAR completo de dependencias jar-with-dependencies.

El ejemplo de este tema usa la versión 3.2.9 del controlador JDBC de MaxCompute.
Ha descargado e instalado SQL Workbench/J.

El ejemplo de este tema usa SQL Workbench/J Build 127, publicado el 22 de agosto de 2020.
Ha instalado Java 8 o una versión posterior.

Procedimiento

Siga estos pasos para conectar SQL Workbench/J a MaxCompute:

Step 1: Create a driver

Cargue el archivo JAR del controlador JDBC de MaxCompute en SQL Workbench/J para que esta herramienta pueda acceder a su proyecto de MaxCompute mediante dicho controlador.
Step 2: Connect SQL Workbench/J to MaxCompute

Configure los parámetros de conexión para vincular SQL Workbench/J con su proyecto de MaxCompute.
Step 3: Manage your MaxCompute project using SQL Workbench/J

Use la conexión de datos establecida en SQL Workbench/J para gestionar su proyecto de MaxCompute.

Paso 1: Crear un controlador

Inicie SQL Workbench y abra la interfaz de la aplicación.

Al abrirse la interfaz de SQL Workbench, aparece automáticamente el cuadro de diálogo Select Connection Profile.
En la esquina inferior izquierda del cuadro de diálogo Select Connection Profile, haga clic en Manage Drivers. Cree un nuevo controlador, introduzca un nombre personalizado, cargue el archivo JAR del controlador JDBC de MaxCompute y luego haga clic en OK para completar la configuración.

Después de cargar el controlador JDBC de MaxCompute, el campo Classname se establece automáticamente en com.aliyun.odps.jdbc.OdpsDriver.

Paso 2: Conectar SQL Workbench/J a MaxCompute

En el panel de configuración de perfil, ubicado en el lado derecho del cuadro de diálogo Select Connection Profile, introduzca un nombre de conexión (por ejemplo, MCtoSQL) y configure los parámetros que se enumeran a continuación.

Parámetro	Descripción
Driver	El controlador usado para conectarse a su proyecto de MaxCompute: el controlador de MaxCompute (com.aliyun.odps.jdbc.OdpsDriver) que creó en Step 1.
URL	La URL para conectarse a su proyecto de MaxCompute. Use el formato `jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true\|false}]`. Elimine los símbolos `<>` durante la configuración. Los parámetros se describen a continuación: <MaxCompute_endpoint>: Obligatorio. El endpoint de la región donde se encuentra su proyecto de MaxCompute. Para consultar la lista de endpoints, véase Endpoints. <MaxCompute_project_name>: Obligatorio. El nombre del proyecto de MaxCompute de destino. Este es el nombre de su proyecto de MaxCompute, no de un espacio de trabajo. Puede iniciar sesión en la consola de MaxCompute, cambiar la región en la esquina superior izquierda y buscar el nombre del proyecto en la página Projects. interactiveMode: Opcional. Especifica si se debe habilitar la función de aceleración de consultas. Para habilitar la aceleración de consultas, agregue `&interactiveMode=true` al final de la URL. Para obtener más información, consulte Query Acceleration.
Username	El AccessKey ID que tiene privilegios de acceso al proyecto de MaxCompute de destino. Puede obtener su AccessKey ID en la página de Gestión de AccessKey.
Password	El AccessKey secret correspondiente al AccessKey ID. Puede obtener su AccessKey secret en la página de Gestión de AccessKey.

Haga clic en Test. Una vez establecida la conexión correctamente, haga clic en OK para crear la conexión de datos entre SQL Workbench/J y MaxCompute.

Paso 3: Gestionar su proyecto de MaxCompute con SQL Workbench/J

En la interfaz de SQL Workbench/J, use la conexión de datos recién creada para gestionar su proyecto de MaxCompute mediante la ejecución de comandos de MaxCompute SQL.

Consultar todas las tablas

Después de crear la conexión de datos, SQL Workbench/J cambia automáticamente a la interfaz de ejecución de SQL. Ejecute el comando show tables; para listar todas las tablas.

Introduzca su sentencia SQL en el área Statement y haga clic en el botón Run (▶) de la barra de herramientas para ejecutarla. Los resultados aparecerán en la pestaña Result situada debajo.
Consultar el esquema de una tabla

Después de crear la conexión de datos, SQL Workbench/J cambia automáticamente a la interfaz de ejecución de SQL. Ejecute el comando desc <table_name>; para ver el esquema de la tabla.
Consultar datos de una tabla

Después de crear la conexión de datos, SQL Workbench/J cambia automáticamente a la interfaz de ejecución de SQL. Ejecute una consulta SELECT para ver los datos de la tabla.

Introduzca una sentencia SQL en el área Statement (por ejemplo, select * from bank_data_pt where age=35;) y haga clic en el botón Execute de la barra de herramientas. Los resultados de la consulta aparecerán en una tabla dentro de la pestaña Result situada debajo.