from_json函式
適用於：
Databricks SQL Databricks Runtime
傳回結構值為 jsonStr 和 schema 的字串。
語法
from_json(jsonStr, schema [, options])
引數
-
jsonStrSTRING：指定 json 文件的運算式。 -
schemaSTRING：schema_of_json函式的表達式或調用。 -
options：指定指示詞的選擇性常MAP<STRING,STRING>值。
jsonStr應該在和schema方面options形成良好的格式。
schema 必須定義為逗號分隔的數據行名稱和數據類型組，類似於 CREATE TABLE中使用的格式。
在 Databricks Runtime 12.2 schema 之前必須是常值。
注意
schema 中的欄位名稱和字段名稱區分大小寫，必須與 jsonStr 中的名稱完全一致。
若要對應唯有不同情況的 JSON 字段，您可以將 產生的結構轉換成 不同的功能變數名稱。
如需詳細資訊，請參閱 範例 。
options如果提供，可以是下列任一項：
-
primitivesAsString（預設false）：將所有基本值推斷為字串類型。 -
prefersDecimal（預設false）：將所有浮點值推斷為十進位類型。 如果值不符合小數，則會將其推斷為雙精度浮點數。 -
allowComments（預設值false）：忽略 JSON 記錄中的 Java 和C++樣式批注。 -
allowUnquotedFieldNames（預設值false）：允許未加上批注的 JSON 功能變數名稱。 -
allowSingleQuotes（預設值true）：除了雙引號之外，還允許單引號。 -
allowNumericLeadingZeros（預設值false）：允許數位中的前置零（例如，00012）。 -
allowBackslashEscapingAnyCharacter（預設值false）：允許使用反斜杠引號機制接受所有字元的引號。 -
allowUnquotedControlChars（預設值false）：允許 JSON 字串包含未加上引號的控制字元（值為小於 32 的 ASCII 字元，包括製表元和行摘要字元）。 -
mode（預設值PERMISSIVE）：允許在剖析期間處理損毀記錄的模式。-
PERMISSIVE：當它符合損毀的記錄時，會將格式錯誤的字串放入 所設定columnNameOfCorruptRecord的欄位中，並將格式不正確的欄位設定為 null。 若要保留損毀的記錄，您可以在使用者定義的架構中設定名為columnNameOfCorruptRecord的字串類型字段。 如果結構沒有該欄位，則會在解析期間捨棄損壞的記錄。 推斷架構時，它會隱含地在輸出架構中新增columnNameOfCorruptRecord字段。 -
FAILFAST：當它符合損毀的記錄時，會擲回例外狀況。
-
-
columnNameOfCorruptRecord（預設值為spark.sql.columnNameOfCorruptRecord中指定的值）：允許重新命名新欄位，其格式不正確的字串是由PERMISSIVE模式所建立。 這會覆寫spark.sql.columnNameOfCorruptRecord。 -
dateFormat（預設值yyyy-MM-dd）：設定表示日期格式的字串。 自訂日期格式會遵循 Datetime 模式的格式。 這適用於日期類型。 -
timestampFormat（預設值yyyy-MM-dd'T'HH:mm:ss[.SSS][XXX]）：設定表示時間戳格式的字串。 自訂日期格式會遵循 Datetime 模式的格式。 這適用於時間戳類型。 -
multiLine（預設值false）：剖析一筆記錄，每個檔案可能會跨越多行。 -
encoding（預設未設定）：允許強制設定 JSON 檔案的標準基本或擴充編碼方式之一。 例如UTF-16BE、UTF-32LE。 如果未指定編碼，且multiLine設定為true，則會自動偵測。 -
lineSep（預設值涵蓋所有\r，\r\n和\n）：定義應該用於剖析的行分隔符。 -
samplingRatio（預設值 1.0）：定義用於架構推斷的輸入 JSON 物件分數。 -
dropFieldIfAllNull（預設false）：在架構推斷期間，是否忽略全部為 Null 值的欄位或是空的陣列/結構。 -
locale（預設值為en-US）：sets地區設定為 IETF BCP 47 格式的語言標記。 例如，這是在剖析日期和時間戳時使用。 -
allowNonNumericNumbers（預設true）：允許 JSON 剖析器將一組非數值標記NaN辨識為合法的浮點數：-
+INF表示正無限，以及和+Infinity的Infinity別名。 -
-INF若為負無限，則為 別名-Infinity。 -
NaN對於其他非數位，例如除以零的結果。
-
-
readerCaseSensitive（預設值true）： 指定啟用時rescuedDataColumn區分大小寫的行為。 如果為 true，請解救名稱與架構不同的數據行;否則，請以不區分大小寫的方式讀取數據。 適用於 Databricks SQL 和 Databricks Runtime 13.3 LTS 和更新版本。
傳回
結構體，其字段名稱和類型符合架構定義。
範例
> SELECT from_json('{"a":1, "b":0.8}', 'a INT, b DOUBLE');
{"a":1,"b":0.8}
-- The column name must to match the case of the JSON field
> SELECT from_json('{"a":1}', 'A INT');
{"A":null}
> SELECT from_json('{"datetime":"26/08/2015"}', 'datetime Timestamp', map('timestampFormat', 'dd/MM/yyyy'));
{"datetime":2015-08-26 00:00:00}
-- Disambiguate field names with different cases
> SELECT cast(from_json('{"a":1, "A":0.8}', 'a INT, A DOUBLE') AS STRUCT<a: INT, b: DOUBLE>);
{"a":1, "b":0.8}