创建 SQL Runner 查询

版本 4.0.23.6（最新）

创建 SQL Runner 查询

必须提供 connection_name 或 model_name 参数。

请求

POST//sql_ queries
数据类型
说明
请求
HTTP 请求
body
HTTP 正文
展开 HTTPBody 定义...
body
SQL Runner 查询
展开 SqlQueryCreate 定义...
connection_name
字符串
要运行此查询的数据库连接的名称
connection_id（连接 ID）
字符串
（已弃用）改用“connection_name”
model_name
字符串
LookML 模型的名称（必须提供此 ID 或 `connection_id`）
sql
字符串
SQL 查询
vis_config
对象
可视化配置属性。这些属性通常不透明，因所用的可视化类型而异。没有已指定的一组允许的键。这些值可以是 JSON 支持的任何类型。通常具有存在字符串值的“类型”键，供 Looker 用来确定显示哪个可视化图表。可视化图表会忽略未知 vis_config 属性。

响应

200：SQL 运行程序查询

数据类型
说明
（对象）
可以
对象
当前用户可以对此对象执行的操作
处理后标题
字符串
SQL 查询的标识符
上次运行时
数值
此查询运行最近一次运行所经过的秒数
运行计数
整数
此查询的运行次数
浏览器限制
整数
此查询将在 SQL Runner 页面上显示的最大行数
sql
字符串
SQL 查询文本
上次运行时间
字符串
最近一次运行此查询的时间
连接
此查询使用的连接
展开 DBConnectionBase 定义...
可以
对象
当前用户可以对此对象执行的操作
name
字符串
连接的名称。也用作唯一标识符
方言
（只读）SQL 方言详情
展开方言定义...
name
字符串
方言的名称
标签
字符串
直观易懂的连接标签
support_cost_Estimated
布尔值
方言是否支持查询费用估算
费用估算样式
字符串
方言如何处理费用估算
持久表索引
字符串
PDT 索引列
Persistent_table_sortkeys
字符串
PDT 排序键列
Persistent_table_distkey
字符串
PDT distkey 列
support_streaming
布尔值
支持在线播放结果
automated_run_sql_runner_snippets
布尔值
是否应自动运行 SQL Runner 代码段
connection_tests
字符串 []
support_inducer
布尔值
使用触发器（即从 sql 生成）支持
support_Multiple_databases
布尔值
可以使用这种方言从连接访问多个数据库
support_Persistent_derived_tables
布尔值
方言是否支持允许 Looker 构建永久性派生表
has_ssl_support
布尔值
数据库是否明确支持通过 JDBC 字符串设置客户端 SSL 支持？
snippets
展开摘要定义...
name
字符串
摘要的名称
标签
字符串
代码段的标签
sql
字符串
代码段的 SQL 文本
pdts_enabled
布尔值
如果此连接上启用了 PDT，则为 true
model_name
字符串
此查询使用的模型名称
创建者
创建此 SQL 查询的用户
展开 UserPublic 定义...
可以
对象
当前用户可以对此对象执行的操作
id
字符串
唯一 ID
first_name（名字）
字符串
名字
last_name（姓氏）
字符串
姓氏
display_name
字符串
要显示的全名（仅在设置了 first_name 和 last_name 的情况下可用）
头像
字符串
头像图片的网址（可能是通用网址）
网址
字符串
用于获取此商品的链接
探索网址
字符串
探索此 SQL 查询的网页网址
明文
布尔值
此查询是否应以纯文本形式呈现
vis_config
对象
可视化配置属性。这些属性通常不透明，因所用的可视化类型而异。没有已指定的一组允许的键。这些值可以是 JSON 支持的任何类型。通常具有存在字符串值的“类型”键，供 Looker 用来确定显示哪个可视化图表。可视化图表会忽略未知 vis_config 属性。
result_maker_id
字符串
ResultMakerLookup 条目的 ID。

400：错误请求

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

404：未找到

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

409：资源已存在

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

422：验证错误

数据类型
说明
（对象）
消息
字符串
错误详情
展开 ValidationErrorDetail 定义...
字段
字符串
出错的字段
代码
字符串
错误代码
消息
字符串
错误信息消息
文档网址
字符串
文档链接
文档网址
字符串
文档链接

429：请求数过多

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

示例