Share via

schema_of_json_agg 聚合函數

  • 發行項

適用於：檢查標示為是 Databricks SQL 檢查標示為是 Databricks Runtime 13.2 和更新版本

以 DDL 格式傳回群組中所有 JSON 字串的合併架構。

語法

schema_of_json_agg(jsonStr [, options] ) [FILTER ( WHERE cond ) ]

您也可以使用 子句，將此函式叫用OVER為視窗函式。

引數

  • jsonStr：具有 的 STRING 常值 JSON。
  • options：選擇性 MAP 常值，索引鍵和值為 STRING。 如需選項的詳細資訊，請參閱 from_json函式。
  • cond：選擇性 BOOLEAN 表達式，篩選用於匯總的數據列。

傳回

STRING儲存結構陣列的定義，其中包含n字串欄位，其中資料行名稱衍生自相異索引鍵集合 JSON 。 域值會保存衍生的格式化 SQL 類型。

每個記錄的架構會依域名合併在一起。 當兩個具有相同名稱的字段在記錄之間有不同的類型時，Azure Databricks 會使用 最不常見的類型。 當不存在這類類型時，類型會衍生為 STRING。 例如，INT和會變成 DOUBLE，而 STRUCT<i INT> 變成 STRINGSTRINGDOUBLE 。

從讀取數據行取得的 JSON 架構與衍生自下列數據行的架構相同。

SELECT * FROM json.`/my/data`;

若要衍生單 JSON 一字串的架構，請使用 schema_of_json 函式。

範例

> SELECT schema_of_json_agg(a) FROM VALUES('{"foo": "bar"}') AS data(a);
  STRUCT<foo: STRING>

> SELECT schema_of_json_agg(a) FROM VALUES('[1]') AS data(a);
  ARRAY<BIGINT>

> CREATE TEMPORARY VIEW data(a) AS VALUES
  ('{"foo": "bar",   "wing": {"ding": "dong"}}'),
  ('{"top": "level", "wing": {"stop": "go"}}')

> SELECT schema_of_json_agg(a) FROM data;
  STRUCT<foo: STRING,top: STRING,wing: STRUCT<ding: STRING, stop: STRING>>