Crear conexión

Versión 4.0.23.4

Crea una conexión con la configuración especificada.

Solicitud

POST /connections
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 Scheme
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.

Respuesta

200: Conexión

Tipo de datos
Descripción
(objeto)
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)
Expandir definición de dialecto...
del espacio
string
El nombre del dialecto
label
string
La etiqueta legible de la conexión
admite_estimación_de_costo
booleano
Si el dialecto admite estimaciones de costo de consulta
estilo_estilo_costo
string
Cómo el dialecto maneja la estimación de costos
Índices de tablas persistentes
string
Columnas de índice PDT
claves_de_clasificación_de_tablas persistentes
string
Columnas de clave de orden de PDT
clave_tabla_persistente
string
Columna de desclave de PDT
admite_transmisión
booleano
Admite resultados de transmisión
automáticamente_run_sql_runner_snippets
booleano
¿Los fragmentos del ejecutor de SQL deberían ejecutarse automáticamente?
pruebas_de_conexión
string[]
admite_inductor
booleano
Es compatible con el inductor (es decir, generar desde SQL).
admite_varias_bases_de_datos
booleano
¿Se puede acceder a varias bases de datos desde una conexión mediante este dialecto?
admite_tablas_derivadas_persistentes
booleano
Si el dialecto permite que Looker compile tablas derivadas persistentes
tiene_ssl_support
booleano
¿La base de datos tiene compatibilidad con SSL de cliente que se puede configurar mediante la string JDBC de forma explícita?
fragmentos
Expandir la definición del fragmento...
del espacio
string
Nombre del fragmento
label
string
Etiqueta del fragmento
sql
string
Texto SQL del fragmento
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 Scheme
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”
Expandir la definición de DBConnectionOverride...
context
string
Contexto en el cual se puede anular (pdt es el único valor permitido)
host
string
Nombre o dirección del host del servidor
puerto
string
Número de puerto en el servidor
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
tiene_contraseña
booleano
Si se anula o no la contraseña en este contexto
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
schema
string
Nombre del Scheme
jdbc_additional_params
string
Parámetros adicionales para agregar a la string de conexión de JDBC
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”
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.

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

409: El recurso ya existe

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

422: Error de validación

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
Expandir la definición de ValidationErrorDetail...
campo
string
Campo con error
código
string
Código de error
mensaje,
string
Mensaje de información de error
url_documentación
string
Vínculo a la documentación
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

Ejemplos