取得資料集 metadata

tw_get_dataset

🇹🇼 Taïwanlecture seule

關鍵字 / Keywords: 資料集 metadata 描述欄位 schema 授權 license dataset info fields

取得資料集完整 metadata 與樣本資料列。

參數： dataset_id: 從 tw_search_datasets 取得的 dataset_id sample_rows: 樣本列數（v1.45.0: 預設 3，硬 cap 3）。設 0 跳過樣本

回傳：metadata（含 schema.columns、schema.row_count、license、source.url、 join_keys、provenance）以及 sample（columns 與 rows）。若資料集尚未 normalise，metadata 會是 None（用 tw_query_rows 觸發 lazy fetch）。

注意：v1.45.0 起 sample_rows 硬 cap 3（原 5、可自訂）— 防止 scraper 用 tw_get_dataset 一次拉多筆繞過 rate limit。想拉完整資料用 tw_query_rows。

Paramètres

Nom	Type	Description
dataset_id *	string	—
sample_rows	integer	—

Schéma JSON brut

{
  "properties": {
    "dataset_id": {
      "title": "Dataset Id",
      "type": "string"
    },
    "sample_rows": {
      "default": 3,
      "title": "Sample Rows",
      "type": "integer"
    }
  },
  "required": [
    "dataset_id"
  ],
  "title": "tw_get_datasetArguments",
  "type": "object"
}

Comment appeler

Amorce — paramètres dans le tableau

tw_get_dataset({ dataset_id: "…" })