版本 4.0.23.6(最新)
使用指定的配置创建连接。
请求
POST
/connections
数据类型
说明
请求
body
展开 HTTPBody 定义...
body
连接
展开 DBConnection 定义...
可以
lock
当前用户可以对此对象执行的操作
name
连接的名称。也用作唯一标识符
方言
lock
(只读)SQL 方言详情
snippets
pdts_enabled
lock
如果此连接上启用了 PDT,则为 true
主机
服务器的主机名/地址;如果是通过 SSH 隧道的连接,则为字符串“localhost”。
端口
服务器上的端口号。如果通过 SSH 隧道进行连接,则表示与 SSH 隧道关联的本地端口。
用户名
服务器身份验证用户名
密码
(只写)服务器身份验证密码
使用 OAuth
lock
连接是否使用 OAuth 进行身份验证。
证书
(只写)采用服务器身份验证的 Base64 编码证书正文(适合使用方言)。
文件类型
(只写)证书密钥文件类型 - .json 或 .p12
数据库
数据库名称
数据库时区
数据库的时区
query_timezone
要在查询中使用的时区
架构
架构名称
max_connections
要使用的并发连接数上限
max_billing_gigabytes
查询的大小上限(以 GB 为单位,BigQuery 仅限 user_attribute 名称)
ssl
连接到服务器时使用 SSL/TLS
验证_SSL
验证 SSL
tmp_db_name
临时数据库的名称(如果使用)
jdbc_additional_params
要添加到 JDBC 连接字符串的其他参数
池超时
连接池超时(秒)
方言名称
(读/写)SQL 方言名称
support_data_studio_link
lock
通过数据库连接,可以通过数据洞察探索开放式数据洞察
创建时间
lock
此连接的创建日期
user_id
lock
上次修改此连接配置的用户 ID
示例
lock
这是示例连接吗?
user_db_credentials
(限制访问功能)是否启用基于用户数据库凭据。启用后,系统将移除之前设置的用户名和密码
user_attribute_fields
维护_cron
用于指定应在何时执行维护(例如 PDT 触发器检查和丢弃)的 Cron 字符串
上次更新日期
lock
上次完成 PDT 触发器检查过程时的 Unix 时间戳
上次更新日期
lock
上次完成 PDT 收获流程开始时的 Unix 时间戳
sql_runner_precache_tables
在 SQL Runner 中预缓存表
sql_writing_with_info_schema
为编写 SQL 提取信息架构
after_connect_statements
在连接到数据库后要发出的 SQL 语句(以英文分号分隔)。需要“custom_after_connect_statements”许可功能
pdt_context_override
“pdt”维护上下文中此连接的 db_connection_override
受管理
lock
此连接是否由 Looker 创建和管理
custom_local_port
此字段仅适用于通过 SSH 隧道的连接。如果手动配置,此字段的值将是与 SSH 隧道关联的本地端口。否则,请输入 NULL 或排除此字段。
tunnel_id [隧道 ID]
此连接使用的 SSH 隧道的 ID
uses_tns
启用透明网络底层 (TNS) 连接
pdt_concurrency
用于并行构建 PDT 的线程数上限
停用上下文相关评论
将 disable_context_comment 设为 true 时,不会将注释添加到 SQL 中
oauth_application_id
用于向数据库进行身份验证的外部 OAuth 应用
始终重试_失败_构建
如果为 true,系统会在每次重新生成程序时重试错误 PDT
cost_estimate_enabled
如果为 true,则探索费用将显示查询费用估算值。
pdt_api_control_enabled
通过 API 可以启动和取消此连接上的 PDT 构建。
响应
200:连接
数据类型
说明
(对象)
可以
lock
当前用户可以对此对象执行的操作
name
连接的名称。也用作唯一标识符
方言
lock
(只读)SQL 方言详情
展开方言定义...
name
lock
方言的名称
标签
lock
直观易懂的连接标签
support_cost_Estimated
lock
方言是否支持查询费用估算
费用估算样式
lock
方言如何处理费用估算
持久表索引
lock
PDT 索引列
Persistent_table_sortkeys
lock
PDT 排序键列
Persistent_table_distkey
lock
PDT distkey 列
support_streaming
lock
支持在线播放结果
automated_run_sql_runner_snippets
lock
是否应自动运行 SQL Runner 代码段
connection_tests
support_inducer
lock
使用触发器(即从 sql 生成)支持
support_Multiple_databases
lock
可以使用这种方言从连接访问多个数据库
support_Persistent_derived_tables
lock
方言是否支持允许 Looker 构建永久性派生表
has_ssl_support
lock
数据库是否明确支持通过 JDBC 字符串设置客户端 SSL 支持?
snippets
展开摘要定义...
name
lock
摘要的名称
标签
lock
代码段的标签
sql
lock
代码段的 SQL 文本
pdts_enabled
lock
如果此连接上启用了 PDT,则为 true
主机
服务器的主机名/地址;如果是通过 SSH 隧道的连接,则为字符串“localhost”。
端口
服务器上的端口号。如果通过 SSH 隧道进行连接,则表示与 SSH 隧道关联的本地端口。
用户名
服务器身份验证用户名
密码
(只写)服务器身份验证密码
使用 OAuth
lock
连接是否使用 OAuth 进行身份验证。
证书
(只写)采用服务器身份验证的 Base64 编码证书正文(适合使用方言)。
文件类型
(只写)证书密钥文件类型 - .json 或 .p12
数据库
数据库名称
数据库时区
数据库的时区
query_timezone
要在查询中使用的时区
架构
架构名称
max_connections
要使用的并发连接数上限
max_billing_gigabytes
查询的大小上限(以 GB 为单位,BigQuery 仅限 user_attribute 名称)
ssl
连接到服务器时使用 SSL/TLS
验证_SSL
验证 SSL
tmp_db_name
临时数据库的名称(如果使用)
jdbc_additional_params
要添加到 JDBC 连接字符串的其他参数
池超时
连接池超时(秒)
方言名称
(读/写)SQL 方言名称
support_data_studio_link
lock
通过数据库连接,可以通过数据洞察探索开放式数据洞察
创建时间
lock
此连接的创建日期
user_id
lock
上次修改此连接配置的用户 ID
示例
lock
这是示例连接吗?
user_db_credentials
(限制访问功能)是否启用基于用户数据库凭据。启用后,系统将移除之前设置的用户名和密码
user_attribute_fields
维护_cron
用于指定应在何时执行维护(例如 PDT 触发器检查和丢弃)的 Cron 字符串
上次更新日期
lock
上次完成 PDT 触发器检查过程时的 Unix 时间戳
上次更新日期
lock
上次完成 PDT 收获流程开始时的 Unix 时间戳
sql_runner_precache_tables
在 SQL Runner 中预缓存表
sql_writing_with_info_schema
为编写 SQL 提取信息架构
after_connect_statements
在连接到数据库后要发出的 SQL 语句(以英文分号分隔)。需要“custom_after_connect_statements”许可功能
pdt_context_override
“pdt”维护上下文中此连接的 db_connection_override
展开 DBConnectionOverride 定义...
context
要替换的上下文(“pdt”是唯一允许的值)
主机
服务器的主机名/地址
端口
服务器上的端口号
用户名
服务器身份验证用户名
密码
(只写)服务器身份验证密码
密码
lock
在这种情况下,密码是否会被替换
证书
(只写)采用服务器身份验证的 Base64 编码证书正文(适合使用方言)。
文件类型
(只写)证书密钥文件类型 - .json 或 .p12
数据库
数据库名称
架构
架构名称
jdbc_additional_params
要添加到 JDBC 连接字符串的其他参数
after_connect_statements
在连接到数据库后要发出的 SQL 语句(以英文分号分隔)。需要“custom_after_connect_statements”许可功能
受管理
lock
此连接是否由 Looker 创建和管理
custom_local_port
此字段仅适用于通过 SSH 隧道的连接。如果手动配置,此字段的值将是与 SSH 隧道关联的本地端口。否则,请输入 NULL 或排除此字段。
tunnel_id [隧道 ID]
此连接使用的 SSH 隧道的 ID
uses_tns
启用透明网络底层 (TNS) 连接
pdt_concurrency
用于并行构建 PDT 的线程数上限
停用上下文相关评论
将 disable_context_comment 设为 true 时,不会将注释添加到 SQL 中
oauth_application_id
用于向数据库进行身份验证的外部 OAuth 应用
始终重试_失败_构建
如果为 true,系统会在每次重新生成程序时重试错误 PDT
cost_estimate_enabled
如果为 true,则探索费用将显示查询费用估算值。
pdt_api_control_enabled
通过 API 可以启动和取消此连接上的 PDT 构建。
400:错误请求
数据类型
说明
(对象)
消息
lock
错误详情
文档网址
lock
文档链接
404:未找到
数据类型
说明
(对象)
消息
lock
错误详情
文档网址
lock
文档链接
409:资源已存在
数据类型
说明
(对象)
消息
lock
错误详情
文档网址
lock
文档链接
422:验证错误
数据类型
说明
(对象)
消息
lock
错误详情
错误
展开 ValidationErrorDetail 定义...
字段
lock
出错的字段
代码
lock
错误代码
消息
lock
错误信息消息
文档网址
lock
文档链接
文档网址
lock
文档链接
429:请求数过多
数据类型
说明
(对象)
消息
lock
错误详情
文档网址
lock
文档链接
示例
Python
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/create_db_connections.py |