Criar conexão

Versão 4.0.23.2

Crie uma conexão usando a configuração especificada.

Solicitação

POST /connections
Tipo de dados
Descrição
Solicitação
HTTPRequest
body
Corpo HTTP
Expandir definição HTTPBody...
body
DBConnection (em inglês)
Conexão
Expandir a definição de DBConnection...
pode
objeto
Operações que o usuário atual pode realizar neste objeto
nome
string
Nome da conexão. Também usado como identificador exclusivo
dialeto
Detalhes somente leitura do SQL Dialect
snippets
pdts_enabled
booleano
Verdadeiro se as TDPs estiverem ativadas nessa conexão
host
string
Nome do host/endereço do servidor ou a string "localhost" no caso de uma conexão por meio de um túnel SSH.
porta
string
Número da porta no servidor. Se a conexão for feita por um túnel SSH, a porta local associada ao túnel SSH.
nome de usuário
string
Nome de usuário para autenticação do servidor
senha
string
(Somente gravação) Senha para autenticação do servidor
usa_oauth
booleano
Se a conexão usa OAuth para autenticação.
certificado
string
(Somente gravação) Corpo de certificado codificado em Base64 para autenticação de servidor (quando apropriado para dialeto).
tipo_de_arquivo
string
Tipo de arquivo de chave de certificado (somente gravação): .json ou .p12
Banco de dados
string
Nome do banco de dados
db_timezone
string
Fuso horário do banco de dados
fuso horário_de_consulta
string
Fuso horário a ser usado em consultas
schema
string
Nome do Scheme
max_connections
integer
Número máximo de conexões simultâneas a serem usadas
max_billing_gigabytes
string
Tamanho máximo da consulta em GB (somente BigQuery, pode ser um nome user_attribute)
ssl
booleano
Usar SSL/TLS ao conectar ao servidor
verificar_ssl
booleano
Verificar o SSL
tmp_db_name
string
Nome do banco de dados temporário (se usado)
jdbc_additional_params
string
Parâmetros adicionais a serem adicionados à string de conexão JDBC
pool_timeout
integer
Tempo limite do pool de conexão, em segundos
dialeto_nome
string
(Leitura/gravação) Nome do dialeto SQL
links_dados_do_studio_de_suporte
booleano
A conexão com o banco de dados é compatível com o Open Data Studio na exploração
criado_em
string
Data de criação desta conexão
user_id
string
ID do usuário que modificou esta configuração de conexão pela última vez
exemplo
booleano
Esse é um exemplo de conexão?
Credenciais_usuário_db
booleano
(Recurso com acesso limitado) As credenciais de db estão ativadas para o usuário. A ativação removerá o nome de usuário e a senha definidos anteriormente
campos_do_atributo_do_usuário
string[]
manutenção_cron
string
String cron que especifica quando a manutenção, como verificações e quedas de acionadores de PDT, deve ser realizada
último_regen_at
string
Carimbo de data/hora do Unix no início do último processo de verificação de gatilho de TDP
last_reap_at
string
Carimbo de data/hora Unix no início do último processo de coleta PDT concluído
sql_runner_precache_tables
booleano
Pré-armazenar tabelas em cache no SQL Runner
sql_writing_with_info_schema
booleano
Buscar esquema de informações para gravação SQL
extratos after_connect_statements
string
Instruções SQL (separadas por ponto e vírgula) que vão ser emitidas após a conexão com o banco de dados. Requer o recurso de licença "custom_after_connect_statements"
pdt_context_override
db_connection_override para esta conexão no contexto de manutenção do `pdt`
managed
booleano
Esta conexão foi criada e gerenciada pelo Looker
porta_local_personalizada
integer
Este campo só é aplicável a conexões em um túnel SSH. O valor desse campo seria a porta local associada ao túnel SSH, se configurada manualmente. Caso contrário, insira NULL ou exclua esse campo.
ID do túnel
string
O ID do túnel SSH que esta conexão usa
utiliza_tns
booleano
Ativar conexões de sub-rede de rede transparente (TNS, na sigla em inglês)
pdt_concurrency
integer
Número máximo de linhas de execução a serem usadas para criar PDTs em paralelo
comentário_desativado_contexto
booleano
Quando "disable_context_comment" for "true", o comentário não será adicionado ao SQL
oauth_application_id
string
Um aplicativo OAuth externo para autenticar no banco de dados
builds_sempre_tentativas_falhas
booleano
Quando verdadeiro, os erros PDTs serão repetidos a cada ciclo do regenerador
cost_estimate_enabled
booleano
Quando verdadeiro, a estimativa de custo de consulta é exibida na exploração.
pdt_api_control_enabled
booleano
Os builds de TDP nessa conexão podem ser iniciados e cancelados pela API.

Resposta

200: conexão

Tipo de dados
Descrição
(objeto)
DBConnection (em inglês)
pode
objeto
Operações que o usuário atual pode realizar neste objeto
nome
string
Nome da conexão. Também usado como identificador exclusivo
dialeto
Detalhes somente leitura do SQL Dialect
Expandir definição do dialeto...
nome
string
O nome do dialeto
Rótulo
string
O rótulo legível da conexão
suporta_custo_estimativa
booleano
Se o dialeto é compatível com estimativas de custo de consulta
custo_estimativa_estilo
string
Como o dialeto processa a estimativa de custos
índices_de_tabelas_permanentes
string
Colunas de índice de TDP
Persistent_table_sortkeys
string
Colunas de chave de classificação de TDP
Persistent_table_distkey
string
Coluna do PDT distkey
suporta
booleano
Suporta resultados de streaming
Automatic_run_sql_runner_snippets
booleano
Os snippets do SQL Runner devem ser executados automaticamente
teste_de_conexão
string[]
suporta_inducer
booleano
É suportado pelo indutor (por exemplo, gerar do sql)
suporta_vários_bancos de dados
booleano
É possível acessar vários bancos de dados de uma conexão usando esse dialeto
tabelas_permanentes_derivadas
booleano
Se o dialeto é compatível com a criação de tabelas derivadas permanentes pelo Looker.
has_ssl_support
booleano
O banco de dados tem suporte ao cliente para SSL definido explicitamente por meio da string JDBC?
snippets
Expandir a definição do snippet...
nome
string
Nome do snippet
Rótulo
string
Rótulo do snippet
sql
string
Texto SQL do snippet
pdts_enabled
booleano
Verdadeiro se as TDPs estiverem ativadas nessa conexão
host
string
Nome do host/endereço do servidor ou a string "localhost" no caso de uma conexão por meio de um túnel SSH.
porta
string
Número da porta no servidor. Se a conexão for feita por um túnel SSH, a porta local associada ao túnel SSH.
nome de usuário
string
Nome de usuário para autenticação do servidor
senha
string
(Somente gravação) Senha para autenticação do servidor
usa_oauth
booleano
Se a conexão usa OAuth para autenticação.
certificado
string
(Somente gravação) Corpo de certificado codificado em Base64 para autenticação de servidor (quando apropriado para dialeto).
tipo_de_arquivo
string
Tipo de arquivo de chave de certificado (somente gravação): .json ou .p12
Banco de dados
string
Nome do banco de dados
db_timezone
string
Fuso horário do banco de dados
fuso horário_de_consulta
string
Fuso horário a ser usado em consultas
schema
string
Nome do Scheme
max_connections
integer
Número máximo de conexões simultâneas a serem usadas
max_billing_gigabytes
string
Tamanho máximo da consulta em GB (somente BigQuery, pode ser um nome user_attribute)
ssl
booleano
Usar SSL/TLS ao conectar ao servidor
verificar_ssl
booleano
Verificar o SSL
tmp_db_name
string
Nome do banco de dados temporário (se usado)
jdbc_additional_params
string
Parâmetros adicionais a serem adicionados à string de conexão JDBC
pool_timeout
integer
Tempo limite do pool de conexão, em segundos
dialeto_nome
string
(Leitura/gravação) Nome do dialeto SQL
links_dados_do_studio_de_suporte
booleano
A conexão com o banco de dados é compatível com o Open Data Studio na exploração
criado_em
string
Data de criação desta conexão
user_id
string
ID do usuário que modificou esta configuração de conexão pela última vez
exemplo
booleano
Esse é um exemplo de conexão?
Credenciais_usuário_db
booleano
(Recurso com acesso limitado) As credenciais de db estão ativadas para o usuário. A ativação removerá o nome de usuário e a senha definidos anteriormente
campos_do_atributo_do_usuário
string[]
manutenção_cron
string
String cron que especifica quando a manutenção, como verificações e quedas de acionadores de PDT, deve ser realizada
último_regen_at
string
Carimbo de data/hora do Unix no início do último processo de verificação de gatilho de TDP
last_reap_at
string
Carimbo de data/hora Unix no início do último processo de coleta PDT concluído
sql_runner_precache_tables
booleano
Pré-armazenar tabelas em cache no SQL Runner
sql_writing_with_info_schema
booleano
Buscar esquema de informações para gravação SQL
extratos after_connect_statements
string
Instruções SQL (separadas por ponto e vírgula) que vão ser emitidas após a conexão com o banco de dados. Requer o recurso de licença "custom_after_connect_statements"
pdt_context_override
db_connection_override para esta conexão no contexto de manutenção do `pdt`
Expandir a definição de DBConnectionOverride...
context
string
Contexto para substituição (o "pdt" é o único valor permitido)
host
string
Nome do host/endereço do servidor
porta
string
Número da porta no servidor
nome de usuário
string
Nome de usuário para autenticação do servidor
senha
string
(Somente gravação) Senha para autenticação do servidor
has_password
booleano
Se a senha foi modificada nesse contexto
certificado
string
(Somente gravação) Corpo de certificado codificado em Base64 para autenticação de servidor (quando apropriado para dialeto).
tipo_de_arquivo
string
Tipo de arquivo de chave de certificado (somente gravação): .json ou .p12
Banco de dados
string
Nome do banco de dados
schema
string
Nome do Scheme
jdbc_additional_params
string
Parâmetros adicionais a serem adicionados à string de conexão JDBC
extratos after_connect_statements
string
Instruções SQL (separadas por ponto e vírgula) que vão ser emitidas após a conexão com o banco de dados. Requer o recurso de licença "custom_after_connect_statements"
managed
booleano
Esta conexão foi criada e gerenciada pelo Looker
porta_local_personalizada
integer
Este campo só é aplicável a conexões em um túnel SSH. O valor desse campo seria a porta local associada ao túnel SSH, se configurada manualmente. Caso contrário, insira NULL ou exclua esse campo.
ID do túnel
string
O ID do túnel SSH que esta conexão usa
utiliza_tns
booleano
Ativar conexões de sub-rede de rede transparente (TNS, na sigla em inglês)
pdt_concurrency
integer
Número máximo de linhas de execução a serem usadas para criar PDTs em paralelo
comentário_desativado_contexto
booleano
Quando "disable_context_comment" for "true", o comentário não será adicionado ao SQL
oauth_application_id
string
Um aplicativo OAuth externo para autenticar no banco de dados
builds_sempre_tentativas_falhas
booleano
Quando verdadeiro, os erros PDTs serão repetidos a cada ciclo do regenerador
cost_estimate_enabled
booleano
Quando verdadeiro, a estimativa de custo de consulta é exibida na exploração.
pdt_api_control_enabled
booleano
Os builds de TDP nessa conexão podem ser iniciados e cancelados pela API.

400: Solicitação inválida

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

404: não encontrado

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

409: recurso já existe

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

422: erro de validação

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
Expandir a definição de ValidationErrorDetail...
campo
string
Campo com erro
código
string
Código do erro
mensagem
string
Mensagem de erro
url_da_documentação
string
Link da documentação
url_da_documentação
string
Link da documentação

429: Solicitações demais

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

Examples