创建查询

版本 4.0.23.4

创建一个查询。

这样，您就可以创建稍后运行的新查询。Looker 查询一经创建便无法更改，因此不会被删除。如果您创建的查询与现有查询完全相同，系统将返回现有查询，并且不会创建新的查询。无论是否创建了新查询，都可以使用“run”方法在返回的查询中使用“id”。

查询参数会以 json 的形式在请求正文中传递。

请求

POST /queries
数据类型
说明
请求
HTTP 请求
body
HTTP 正文
展开 HTTPBody 定义...
body
查询
展开查询定义...
可以
对象
当前用户可以对此对象执行的操作
id
字符串
唯一 ID
模型
字符串
模型
视图
字符串
探索名称
字段
字符串 []
数据透视
字符串 []
fill_fields
字符串 []
filters
对象
过滤器
过滤条件表达式
字符串
过滤条件表达式
排序
字符串 []
限制
字符串
限制
列限制
字符串
列数上限
总计
布尔值
总计
总行数
字符串
原始总计
小计
字符串 []
vis_config
对象
可视化配置属性。这些属性通常不透明，因所用的可视化类型而异。没有已指定的一组允许的键。这些值可以是 JSON 支持的任何类型。通常具有存在字符串值的“类型”键，供 Looker 用来确定显示哪个可视化图表。可视化图表会忽略未知 vis_config 属性。
过滤条件配置
对象
filter_config 表示给定查询的探索页面上的过滤条件界面的状态。通过 Looker 界面运行查询时，此参数的优先级高于“过滤器”。创建查询或修改现有查询时，应将“filter_config”设置为 null。将其设置为任何其他值都可能会导致意外的过滤行为。该格式应视为不透明。
visible_ui_sections
字符串
可见界面部分
处理后标题
字符串
Slug
动态字段
字符串
动态字段
client_id
字符串
客户端 ID：用于生成缩短的探索网址。如果由客户端设置，则必须是唯一的 22 位字母数字字符串。否则，系统会生成一个。
分享网址
字符串
分享网址
展开网址共享网址
字符串
展开后的共享网址
网址
字符串
展开后的网址
query_timezone
字符串
查询时区
has_table_calculations
布尔值
包含表计算
查询
HTTPQuery
展开 HTTPQuery 定义...
字段
字符串
请求的字段。

响应

200：查询

数据类型
说明
（对象）
可以
对象
当前用户可以对此对象执行的操作
id
字符串
唯一 ID
模型
字符串
模型
视图
字符串
探索名称
字段
字符串 []
数据透视
字符串 []
fill_fields
字符串 []
filters
对象
过滤器
过滤条件表达式
字符串
过滤条件表达式
排序
字符串 []
限制
字符串
限制
列限制
字符串
列数上限
总计
布尔值
总计
总行数
字符串
原始总计
小计
字符串 []
vis_config
对象
可视化配置属性。这些属性通常不透明，因所用的可视化类型而异。没有已指定的一组允许的键。这些值可以是 JSON 支持的任何类型。通常具有存在字符串值的“类型”键，供 Looker 用来确定显示哪个可视化图表。可视化图表会忽略未知 vis_config 属性。
过滤条件配置
对象
filter_config 表示给定查询的探索页面上的过滤条件界面的状态。通过 Looker 界面运行查询时，此参数的优先级高于“过滤器”。创建查询或修改现有查询时，应将“filter_config”设置为 null。将其设置为任何其他值都可能会导致意外的过滤行为。该格式应视为不透明。
visible_ui_sections
字符串
可见界面部分
处理后标题
字符串
Slug
动态字段
字符串
动态字段
client_id
字符串
客户端 ID：用于生成缩短的探索网址。如果由客户端设置，则必须是唯一的 22 位字母数字字符串。否则，系统会生成一个。
分享网址
字符串
分享网址
展开网址共享网址
字符串
展开后的共享网址
网址
字符串
展开后的网址
query_timezone
字符串
查询时区
has_table_calculations
布尔值
包含表计算

400：错误请求

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

404：未找到

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

409：资源已存在

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

422：验证错误

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

429：请求数过多

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

示例

Python

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py

Ruby

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/ruby/update_look.rb

Kotlin

https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestMethods.kt
https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestMethods.kt
https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestSmoke.kt

TypeScript

https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts

Swift

https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/smokeTests.swift）
https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/smokeTests.swift）