from_json 函式
適用於：
Databricks SQL Databricks Runtime
傳回具有 jsonStr 和 schema的結構值。
語法
from_json(jsonStr, schema [, options])
引數
jsonStr：指定 json 檔的 STRING 表達式。schema：schema_of_json函式的 STRING 運算式或調用。options：選擇性的 MAP<STRING，STRING> 常值指定指示詞。
jsonStr應該在和options方面schema形成良好的格式。
schema 必須定義為逗號分隔的資料列名稱和資料類型組，例如 CREATE TABLE。 在 Databricks Runtime 12.2 schema 之前必須是常值。
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');
{1,0.8}
> SELECT from_json('{"time":"26/08/2015"}', 'time Timestamp', map('timestampFormat', 'dd/MM/yyyy'));
{2015-08-26 00:00:00}