测试连接配置

版本 4.0.23.6（最新）

测试连接配置。

请注意，连接的“dialect”属性具有“connection_tests”属性，其中列出了连接支持的特定类型的测试。

此 API 有速率限制。

该请求中不受支持的测试将被忽略。

请求

PUT /connections/test
数据类型
说明
请求
HTTP 请求
body
HTTP 正文
展开 HTTPBody 定义...
body
连接
展开 DBConnection 定义...
可以
对象
当前用户可以对此对象执行的操作
name
字符串
连接的名称。也用作唯一标识符
方言
（只读）SQL 方言详情
snippets
pdts_enabled
布尔值
如果此连接上启用了 PDT，则为 true
主机
字符串
服务器的主机名/地址；如果是通过 SSH 隧道的连接，则为字符串“localhost”。
端口
字符串
服务器上的端口号。如果通过 SSH 隧道进行连接，则表示与 SSH 隧道关联的本地端口。
用户名
字符串
服务器身份验证用户名
密码
字符串
（只写）服务器身份验证密码
使用 OAuth
布尔值
连接是否使用 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
布尔值
通过数据库连接，可以通过数据洞察探索开放式数据洞察
创建时间
字符串
此连接的创建日期
user_id
字符串
上次修改此连接配置的用户 ID
示例
布尔值
这是示例连接吗？
user_db_credentials
布尔值
（限制访问功能）是否启用基于用户数据库凭据。启用后，系统将移除之前设置的用户名和密码
user_attribute_fields
字符串 []
维护_cron
字符串
用于指定应在何时执行维护（例如 PDT 触发器检查和丢弃）的 Cron 字符串
上次更新日期
字符串
上次完成 PDT 触发器检查过程时的 Unix 时间戳
上次更新日期
字符串
上次完成 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
受管理
布尔值
此连接是否由 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 构建。
查询
HTTPQuery
展开 HTTPQuery 定义...
测试
字符串 []

响应

200：测试结果

数据类型
说明
（数组）
可以
对象
当前用户可以对此对象执行的操作
连接字符串
字符串
JDBC 连接字符串。（仅在“连接”测试中填充）
消息
字符串
测试结果
name
字符串
测试名称
状态
字符串
测试结果代码

400：错误请求

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

404：未找到

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

429：请求数过多

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接