获取查询

版本 4.0.23.6（最新）

按 ID 获取之前创建的查询。

Looker 查询对象包含各种参数，它们定义了已运行或日后可以运行的数据库查询。这些参数包括：模型、视图、字段、过滤条件、数据透视等。查询结果不是查询对象的一部分。

查询对象是唯一且不可变的。当用户探索数据时，系统会自动在 Looker 中创建查询对象。Looker 不会删除它们，而是会添加到查询历史记录中。当系统要求您为任何一组参数创建查询时，Looker 会首先尝试查找具有匹配参数的现有查询对象，并且仅在未找到相应的对象时才创建新对象。

此“get”方法用于获取有关给定 ID 的查询的详细信息。请参阅这里的其他“创建”和“运行”查询方法。

请注意，“filter_config”和“vis_config”等某些字段特定于 Looker 界面如何构建查询和可视化，通常不适用于 API。创建新查询时不需要这些，但通常可以忽略。

请求

GET /queries/{query_id}
数据类型
说明
请求
HTTP 请求
路径
HTTP 路径
展开 HTTPPath 定义...
查询 ID
字符串
查询的 ID
查询
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：未找到

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

示例