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}