版本 3.1.23.2
创建一个查询。
这样,您就可以创建稍后运行的新查询。Looker 查询一经创建便无法更改,因此不会被删除。如果您创建的查询与现有查询完全相同,系统将返回现有查询,并且不会创建新的查询。无论是否创建了新查询,都可以使用“run”方法在返回的查询中使用“id”。
查询参数会以 json 的形式在请求正文中传递。
请求
POST
/queries
数据类型
说明
请求
body
展开 HTTPBody 定义...
body
查询
展开查询定义...
可以
lock
当前用户可以对此对象执行的操作
id
lock
唯一 ID
模型
模型
视图
探索名称
字段
数据透视
fill_fields
filters
过滤器
过滤条件表达式
过滤条件表达式
排序
限制
限制
列限制
列数上限
总计
总计
总行数
原始总计
小计
vis_config
可视化配置属性。这些属性通常不透明,因所用的可视化类型而异。没有已指定的一组允许的键。这些值可以是 JSON 支持的任何类型。通常具有存在字符串值的“类型”键,供 Looker 用来确定显示哪个可视化图表。可视化图表会忽略未知 vis_config 属性。
过滤条件配置
filter_config 表示给定查询的探索页面上的过滤条件界面的状态。通过 Looker 界面运行查询时,此参数的优先级高于“过滤器”。创建查询或修改现有查询时,应将“filter_config”设置为 null。将其设置为任何其他值都可能会导致意外的过滤行为。该格式应视为不透明。
visible_ui_sections
可见界面部分
处理后标题
lock
Slug
动态字段
动态字段
client_id
客户端 ID:用于生成缩短的探索网址。如果由客户端设置,则必须是唯一的 22 位字母数字字符串。否则,系统会生成一个。
分享网址
lock
分享网址
展开网址共享网址
lock
展开后的共享网址
网址
lock
展开后的网址
query_timezone
查询时区
has_table_calculations
lock
包含表计算
runtime
(已弃用)运行时(已弃用)
查询
展开 HTTPQuery 定义...
字段
请求的字段。
响应
200:查询
数据类型
说明
(对象)
可以
lock
当前用户可以对此对象执行的操作
id
lock
唯一 ID
模型
模型
视图
探索名称
字段
数据透视
fill_fields
filters
过滤器
过滤条件表达式
过滤条件表达式
排序
限制
限制
列限制
列数上限
总计
总计
总行数
原始总计
小计
vis_config
可视化配置属性。这些属性通常不透明,因所用的可视化类型而异。没有已指定的一组允许的键。这些值可以是 JSON 支持的任何类型。通常具有存在字符串值的“类型”键,供 Looker 用来确定显示哪个可视化图表。可视化图表会忽略未知 vis_config 属性。
过滤条件配置
filter_config 表示给定查询的探索页面上的过滤条件界面的状态。通过 Looker 界面运行查询时,此参数的优先级高于“过滤器”。创建查询或修改现有查询时,应将“filter_config”设置为 null。将其设置为任何其他值都可能会导致意外的过滤行为。该格式应视为不透明。
visible_ui_sections
可见界面部分
处理后标题
lock
Slug
动态字段
动态字段
client_id
客户端 ID:用于生成缩短的探索网址。如果由客户端设置,则必须是唯一的 22 位字母数字字符串。否则,系统会生成一个。
分享网址
lock
分享网址
展开网址共享网址
lock
展开后的共享网址
网址
lock
展开后的网址
query_timezone
查询时区
has_table_calculations
lock
包含表计算
runtime
(已弃用)运行时(已弃用)
400:错误请求
数据类型
说明
(对象)
消息
lock
错误详情
文档网址
lock
文档链接
404:未找到
数据类型
说明
(对象)
消息
lock
错误详情
文档网址
lock
文档链接
409:资源已存在
数据类型
说明
(对象)
消息
lock
错误详情
文档网址
lock
文档链接
422:验证错误
数据类型
说明
(对象)
消息
lock
错误详情
错误
展开 ValidationErrorDetail 定义...
字段
lock
出错的字段
代码
lock
错误代码
消息
lock
错误信息消息
文档网址
lock
文档链接
文档网址
lock
文档链接
429:请求数过多
数据类型
说明
(对象)
消息
lock
错误详情
文档网址
lock
文档链接
示例
Python
Ruby
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/ruby/update_look.rb |
Kotlin
TypeScript
Swift