Prueba la configuración de conexión

Versión 4.0.23.6 (más reciente)

Probar una configuración de conexión

Ten en cuenta que la propiedad “dialect” de una conexión tiene una propiedad “connection_tests” que enumera los tipos específicos de pruebas que admite la conexión.

Esta API tiene un límite de frecuencia.

Se ignorarán las pruebas no admitidas en la solicitud.

Solicitud

PUT /connections/test
Tipo de datos
Descripción
Solicitud
HTTPRequest
body
Cuerpo HTTP
Expandir la definición HTTPBody...
body
Conexión
Expandir la definición de DBConnection...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
del espacio
string
Nombre de la conexión. También se usa como identificador único.
dialecto
Detalles de solo lectura de SQL (solo lectura)
fragmentos
pdts_habilitado
booleano
Verdadero si las PDT están habilitadas en esta conexión
host
string
Nombre o dirección del host del servidor; o la string “localhost” en caso de una conexión a través de un túnel SSH.
puerto
string
Número de puerto en el servidor Si la conexión es a través de un túnel SSH, el puerto local asociado al túnel SSH.
nombre de usuario
string
Nombre de usuario para la autenticación del servidor
contraseña
string
Contraseña (solo escritura) para la autenticación del servidor
uses_oauth
booleano
Indica si la conexión usa OAuth para la autenticación.
certificado
string
(Solo escritura) Cuerpo de certificado codificado en Base64 para la autenticación del servidor (cuando es apropiado para el dialecto).
tipo de archivo
string
(Solo lectura) Tipo de archivo de clave del certificado: .json o .p12
base de datos
string
Nombre de la base de datos
base de datos_db
string
Zona horaria de la base de datos
zona horaria de consulta
string
Zona horaria que se usará en las consultas
schema
string
Nombre del esquema
max_connections
integer
Cantidad máxima de conexiones simultáneas que se pueden usar
max_billing_gigabytes
string
Tamaño máximo de la consulta en GB (solo BigQuery, puede ser un nombre de atributo del usuario)
ssl
booleano
Usar SSL/TLS para conectarse al servidor
verifica_ssl
booleano
Verificar la SSL
tmp_db_name
string
Nombre de la base de datos temporal (si se usa)
jdbc_additional_params
string
Parámetros adicionales para agregar a la string de conexión de JDBC
pool_timeout
integer
Tiempo de espera del grupo de conexiones, en segundos
dialect_name
string
(Lectura/escritura) Nombre del dialecto de SQL
admite_data_studio_link
booleano
La conexión de la base de datos permite admitir Open Data Studio a partir de la exploración
creado_en
string
Fecha de creación de esta conexión
user_id
string
ID del usuario que modificó por última vez esta configuración de conexión
ejemplo
booleano
¿Esta es una conexión de ejemplo?
user_db_credentials
booleano
(función de acceso limitado) Las credenciales de base de datos por usuario están habilitadas. Si habilitas la opción, se quitarán el nombre de usuario y la contraseña establecidos anteriormente.
campos_atributo_del_usuario
string[]
mantenimiento_cron
string
String cron que especifica cuándo se deben realizar el mantenimiento, como las disminuciones y comprobaciones del activador PDT
última_gen.
string
Marca de tiempo de Unix al inicio del último proceso de verificación del activador del PDT completado
última_cosa_en
string
Marca de tiempo de Unix al inicio del último proceso de recolección de PDT completado
sql_runner_precache_tables
booleano
Tablas prealmacenas en el ejecutor de SQL
sql_coding_with_info_schema
booleano
Esquema de recuperación de información para escritura de SQL
sentencias after_connect
string
Instrucciones de SQL (separadas por punto y coma) que se emitirán después de conectarse a la base de datos. Requiere la función de licencia “custom_after_connect_statements”
pdt_context_override
db_connection_override para esta conexión en el contexto de mantenimiento “pdt”
administrada
booleano
Looker creó y administra esta conexión.
puerto_local_personalizado
integer
Este campo solo se aplica a conexiones a través de un túnel SSH. El valor de este campo sería el puerto local asociado con el túnel SSH si se configurara manualmente. De lo contrario, ingrese NULL o excluya este campo.
ID del túnel
string
El ID del túnel SSH que utiliza esta conexión
use_tns
booleano
Habilitar conexiones de Sustrato de red transparente (TNS)
pdt_simultaneidad
integer
Cantidad máxima de subprocesos para usar en la compilación de PDT en paralelo
disable_context_comment
booleano
Cuando disable_context_comment es verdadero, no se agregan comentarios a SQL
ID de aplicación de OAuth
string
Una aplicación de OAuth externa para usar en la autenticación de la base de datos
compilaciones_con_errores_siempre
booleano
Cuando sea verdadero, se reintentarán las PDT de error cada ciclo del regenerador
costo_estimado_habilitado
booleano
Si es verdadero, la estimación del costo de la consulta se mostrará en Explorar.
pdt_api_control_enabled
booleano
Las compilaciones de PDT en esta conexión se pueden iniciar y cancelar a través de la API.
verá la consulta cuando se guarde
HTTPQuery
Expandir definición de HTTPQuery...
pruebas
string[]

Respuesta

200: Resultados de la prueba

Tipo de datos
Descripción
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
string_conexión
string
String de conexión de JDBC. (solo propagado en la prueba "connect")
mensaje,
string
Mensaje de resultado de prueba
del espacio
string
Nombre de la prueba
Calendario
string
Código de resultado de la prueba

400: Bad Request

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

404: No encontrado

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

429: Demasiadas solicitudes

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación