DATASET · qveris

QVeris 并集数据集目录

qveris.canonical_dataset_registry

qveris_union

QVeris × WarrenHub 并集的数据集清单，一行一个 canonical_dataset_id，含领域、平台/市场、实体类型、粒度、时间语义与并集裁决。查其他 qveris.* 表前先在这里取 canonical_dataset_id。注意：许可与免费源相关列目前仍是建表默认值，未回填；权威许可口径见 ops.source_catalog 中 qveris_ 开头的行。

下载本类 JSON 下载完整 JSON.gz 先获取 Key

字段30

关键字段1

更新口径producer_schedule

时间列updated_at

单页上限5000

分页窄筛选

PIT不支持

规模view

WHAT IT ANSWERS

这张表适合回答什么

按领域或平台检索有哪些并集数据集
确认某数据集是新增、复用现有还是被阻塞
为 qveris.generic_record 等表取得必填的 canonical_dataset_id

GRAIN & TIME

一行代表什么

业务粒度: 每行代表“QVeris 并集数据集目录”的一条记录；逻辑粒度由 canonical_dataset_id 共同确定。
时间口径: 以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。
更新节奏: 由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。

KEY FIELDS

先看这些字段

canonical_dataset_id: 用于识别 canonical dataset 的业务标识。

RECOMMENDED JOINS

怎样和其他表关联

该表主要按自身业务键使用，目前没有推荐的跨表主键联接。

HOW TO QUERY SAFELY

查询方法与已知限制

先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。

返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。

MACHINE CONTRACT

筛选、排序与分页

UNVERSIONED

默认排序: canonical_dataset_id
唯一键: —
读取模式: relation_default
最大时间窗: 未单独限制

可用 filters

canonical_dataset_id→ canonical_dataset_id · string

data_type→ data_type · string

domain→ domain · string

entity_type→ entity_type · string

free_source_grade→ free_source_grade · string

granularity→ granularity · string

history_grade→ history_grade · string

platform_or_market→ platform_or_market · string

status→ status · string

union_disposition→ union_disposition · string

POINT IN TIME

可复现读取

NOT AVAILABLE

该资产没有 PIT 契约。普通 rows 端点仍按当前公开读模式返回数据；不要把它表述成历史时点快照。

COPY-READY CALLS

怎么调用

同一数据集可用 HTTP、Python SDK、CLI 或 MCP；Key 始终只通过环境变量/Bearer Header 传递。

READ ONLY

HTTP

curl --fail-with-body -H "Authorization: Bearer $FRIENDS_DATA_API_KEY" "https://api.alphahubs.uk/api/v1/data/datasets/qveris/canonical_dataset_registry/rows?limit=100&start=2026-08-01&end=2026-08-01"

PYTHON SDK

from friends_data_api import FriendsDataClient, Settings

async with FriendsDataClient(Settings.from_env()) as client:
    page = await client.get_dataset_rows('qveris', 'canonical_dataset_registry', limit=100, start='2026-08-01', end='2026-08-01')
    print(page.data)
    if page.has_more:
        print("next cursor:", page.next_cursor)

CLI

friends-data get-dataset-rows qveris canonical_dataset_registry --limit 100 --start 2026-08-01 --end 2026-08-01

MCP TOOL CALL

{
  "arguments": {
    "dataset": "canonical_dataset_registry",
    "end": "2026-08-01",
    "filters": {},
    "limit": 100,
    "namespace": "qveris",
    "start": "2026-08-01"
  },
  "tool": "get_dataset_rows"
}

FIELD DICTIONARY

30 个返回字段

descriptionSource 可在 JSON 中区分仓库注释、标准术语表和名称推导说明。

筛选字段

#	字段	ClickHouse 类型	JSON	可空	角色	说明
1	`canonical_dataset_id`	`String`	`string`	no	filter, default_order	Identifier for canonical dataset.名称推导
2	`canonicalization_version`	`LowCardinality(String)`	`string`	no	value	Source-normalized field: canonicalization version.名称推导
3	`source_dataset_key`	`String`	`string`	no	value	Source-normalized field: source dataset key.名称推导
4	`domain`	`LowCardinality(String)`	`string`	no	filter	Source-normalized field: domain.名称推导
5	`platform_or_market`	`LowCardinality(String)`	`string`	no	filter	Source-normalized field: platform or market.名称推导
6	`entity_type`	`LowCardinality(String)`	`string`	no	filter	Source-normalized field: entity type.名称推导
7	`data_type`	`LowCardinality(String)`	`string`	no	filter	Source-normalized field: data type.名称推导
8	`scope`	`LowCardinality(String)`	`string`	no	value	Source-normalized field: scope.名称推导
9	`granularity`	`LowCardinality(String)`	`string`	no	filter	Source-normalized field: granularity.名称推导
10	`temporal_semantics`	`LowCardinality(String)`	`string`	no	value	Source-normalized field: temporal semantics.名称推导
11	`field_set_version`	`String`	`string`	no	value	Source-normalized field: field set version.名称推导
12	`union_disposition`	`LowCardinality(String)`	`string`	no	filter	Source-normalized field: union disposition.名称推导
13	`primary_source_kind`	`LowCardinality(String)`	`string`	no	value	Source-normalized field: primary source kind.名称推导
14	`existing_dataset`	`String`	`string`	no	value	Source-normalized field: existing dataset.名称推导
15	`history_grade`	`LowCardinality(String)`	`string`	no	filter	Source-normalized field: history grade.名称推导
16	`observed_history_start`	`Nullable(DateTime64(3, 'UTC'))`	`string / date-time`	yes	value	Source-normalized field: observed history start.名称推导
17	`observed_history_end`	`Nullable(DateTime64(3, 'UTC'))`	`string / date-time`	yes	value	Source-normalized field: observed history end.名称推导
18	`history_complete`	`UInt8`	`integer`	no	value	Source-normalized field: history complete.名称推导
19	`historical_treatment`	`LowCardinality(String)`	`string`	no	value	Source-normalized field: historical treatment.名称推导
20	`selected_source_kind`	`LowCardinality(String)`	`string`	no	value	Source-normalized field: selected source kind.名称推导
21	`underlying_canonical_dataset_id`	`String`	`string`	no	value	Identifier for underlying canonical dataset.名称推导
22	`license_scope`	`LowCardinality(String)`	`string`	no	provenance	License or redistribution scope attached to the row.标准术语表
23	`retention_class`	`LowCardinality(String)`	`string`	no	value	Source-normalized field: retention class.名称推导
24	`free_source_grade`	`LowCardinality(String)`	`string`	no	filter	Source-normalized field: free source grade.名称推导
25	`free_source_connector_status`	`LowCardinality(String)`	`string`	no	value	Source-normalized field: free source connector status.名称推导
26	`free_source_cron_status`	`LowCardinality(String)`	`string`	no	value	Source-normalized field: free source cron status.名称推导
27	`status`	`LowCardinality(String)`	`string`	no	filter	Source-normalized field: status.名称推导
28	`decision_reason_code`	`LowCardinality(String)`	`string`	no	value	Source-normalized field: decision reason code.名称推导
29	`version`	`UInt64`	`integer`	no	provenance	Monotonic row version used for correction-aware reads.标准术语表
30	`updated_at`UTC_datetime	`DateTime64(3, 'UTC')`	`string / date-time`	no	time	UTC timestamp when the warehouse row was last updated.标准术语表

字典口径

结构来自 Friends 只读身份可见的真实 serving relation；权限、过滤、排序、PIT 与分页来自可执行 DatasetSpec。Schema observed at 2026-10-06T18:08:52Z。