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
body
Expandir la definición HTTPBody...
body
Conexión
Expandir la definición de DBConnection...
que pueden
lock
Operaciones que el usuario actual puede realizar en este objeto
del espacio
Nombre de la conexión. También se usa como identificador único.
dialecto
lock
Detalles de solo lectura de SQL (solo lectura)
fragmentos
pdts_habilitado
lock
Verdadero si las PDT están habilitadas en esta conexión
host
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
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
Nombre de usuario para la autenticación del servidor
contraseña
Contraseña (solo escritura) para la autenticación del servidor
uses_oauth
lock
Indica si la conexión usa OAuth para la autenticación.
certificado
(Solo escritura) Cuerpo de certificado codificado en Base64 para la autenticación del servidor (cuando es apropiado para el dialecto).
tipo de archivo
(Solo lectura) Tipo de archivo de clave del certificado: .json o .p12
base de datos
Nombre de la base de datos
base de datos_db
Zona horaria de la base de datos
zona horaria de consulta
Zona horaria que se usará en las consultas
schema
Nombre del esquema
max_connections
Cantidad máxima de conexiones simultáneas que se pueden usar
max_billing_gigabytes
Tamaño máximo de la consulta en GB (solo BigQuery, puede ser un nombre de atributo del usuario)
ssl
Usar SSL/TLS para conectarse al servidor
verifica_ssl
Verificar la SSL
tmp_db_name
Nombre de la base de datos temporal (si se usa)
jdbc_additional_params
Parámetros adicionales para agregar a la string de conexión de JDBC
pool_timeout
Tiempo de espera del grupo de conexiones, en segundos
dialect_name
(Lectura/escritura) Nombre del dialecto de SQL
admite_data_studio_link
lock
La conexión de la base de datos permite admitir Open Data Studio a partir de la exploración
creado_en
lock
Fecha de creación de esta conexión
user_id
lock
ID del usuario que modificó por última vez esta configuración de conexión
ejemplo
lock
¿Esta es una conexión de ejemplo?
user_db_credentials
(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
mantenimiento_cron
String cron que especifica cuándo se deben realizar el mantenimiento, como las disminuciones y comprobaciones del activador PDT
última_gen.
lock
Marca de tiempo de Unix al inicio del último proceso de verificación del activador del PDT completado
última_cosa_en
lock
Marca de tiempo de Unix al inicio del último proceso de recolección de PDT completado
sql_runner_precache_tables
Tablas prealmacenas en el ejecutor de SQL
sql_coding_with_info_schema
Esquema de recuperación de información para escritura de SQL
sentencias after_connect
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
lock
Looker creó y administra esta conexión.
puerto_local_personalizado
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
El ID del túnel SSH que utiliza esta conexión
use_tns
Habilitar conexiones de Sustrato de red transparente (TNS)
pdt_simultaneidad
Cantidad máxima de subprocesos para usar en la compilación de PDT en paralelo
disable_context_comment
Cuando disable_context_comment es verdadero, no se agregan comentarios a SQL
ID de aplicación de OAuth
Una aplicación de OAuth externa para usar en la autenticación de la base de datos
compilaciones_con_errores_siempre
Cuando sea verdadero, se reintentarán las PDT de error cada ciclo del regenerador
costo_estimado_habilitado
Si es verdadero, la estimación del costo de la consulta se mostrará en Explorar.
pdt_api_control_enabled
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
Expandir definición de HTTPQuery...
pruebas
Respuesta
200: Resultados de la prueba
Tipo de datos
Descripción
(array)
que pueden
lock
Operaciones que el usuario actual puede realizar en este objeto
string_conexión
lock
String de conexión de JDBC. (solo propagado en la prueba "connect")
mensaje,
lock
Mensaje de resultado de prueba
del espacio
lock
Nombre de la prueba
Calendario
lock
Código de resultado de la prueba
400: Bad Request
Tipo de datos
Descripción
(objeto)
mensaje,
lock
Detalles del error
url_documentación
lock
Vínculo a la documentación
404: No encontrado
Tipo de datos
Descripción
(objeto)
mensaje,
lock
Detalles del error
url_documentación
lock
Vínculo a la documentación
429: Demasiadas solicitudes
Tipo de datos
Descripción
(objeto)
mensaje,
lock
Detalles del error
url_documentación
lock
Vínculo a la documentación