資料類型

適用於： Databricks SQL Databricks Runtime

如需管理數據類型之間衝突解決方式的規則，請參閱 SQL 數據類型規則。

支援的資料類型

Azure Databricks 支援下列數據類型：

資料類型	描述
BIGINT	表示8位元組帶正負號的整數。
二元的	表示位元組序列值。
布爾	表示布爾值。
DATE	表示值，包含欄位年、月和日的值，不含時區。
DECIMAL（p，s）	表示最大有效位數 p 和固定小數位數 s的數位。
DOUBLE	表示8位元組雙精確度浮點數。
FLOAT	表示 4 位元組單精度浮點數。
INT	表示 4 位元組帶正負號的整數。
INTERVAL intervalQualifier	表示以秒或月數的刻度表示時間間隔。
VOID	表示不具類型的 NULL。
SMALLINT	表示2位元組帶正負號的整數。
字串	表示字元字串值。
TIMESTAMP	表示值，包含欄位年、月、日、小時、分鐘和秒的值，以及會話本地時區。
TIMESTAMP_NTZ	代表由欄位年、月、日、小時、分鐘和秒組成的值。 執行所有作業，無需考慮任何時區。
TINYINT	表示1位元組帶正負號的整數。
ARRAY < elementType >	表示值，包含具有 型別 elementType的項目序列。
MAP < keyType，valueType >	表示包含一組索引鍵/值組的值。
STRUCT < [fieldName ： fieldType [NOT NULL][COMMENT str][， ...]] >	表示具有欄位序列所描述結構的值。
變體	表示半結構化數據。
物件	表示 中的 VARIANT 值，其中包含一組欄位所描述的結構。

重要

Delta Lake 不支持 VOID 類型。

數據類型分類

資料類型會分組為下列類別：

• 整數數值 類型代表整數：
  • TINYINT
  • SMALLINT
  • INT
  • BIGINT
• 確切的數值 類型代表base-10數位：
  • 整數數值
  • DECIMAL
• 二進位浮點 類型使用指數和二進位表示法來涵蓋大量的數位：
  • FLOAT
  • DOUBLE
• 數值類型 代表所有數值資料類型：
  • 精確數值
  • 二進位浮點數
• 日期時間 類型代表日期和時間元件：
  • DATE
  • TIMESTAMP
  • TIMESTAMP_NTZ
• 簡單 類型是藉由持有單一值所定義的類型：
  • 數值的
  • 日期時間
  • 二元的
  • 布爾
  • INTERVAL
  • 字串
• 複雜 類型是由複雜或 簡單類型的多個元件所組成：
  • 陣列
  • 地圖
  • 結構
  • 變體
  • 物件

語言對應

適用於： Databricks Runtime

Scala

Spark SQL 資料類型定義於封裝 org.apache.spark.sql.types中。 您可以匯入套件來存取它們：

import org.apache.spark.sql.types._

SQL 類型	資料類型	值類型	用來存取或建立數據類型的 API
TINYINT	ByteType	Byte	ByteType
SMALLINT	ShortType	Short	ShortType
INT	IntegerType	int	IntegerType
BIGINT	LongType	Long	LongType
FLOAT	FloatType	Float	FloatType
DOUBLE	DoubleType	雙重	DoubleType
DECIMAL（p，s）	DecimalType	java.math.BigDecimal	DecimalType
字串	StringType	String	StringType
二元的	BinaryType	Array[Byte]	BinaryType
布爾	BooleanType	布林值	BooleanType
TIMESTAMP	TimestampType	java.sql.Timestamp	TimestampType
TIMESTAMP_NTZ	TimestampNTZType	java.time.LocalDateTime	TimestampNTZType
DATE	DateType	java.sql.Date	DateType
year-month interval	YearMonthIntervalType	java.time.Period	YearMonthIntervalType （3）
day-time interval	DayTimeIntervalType	java.time.Duration	DayTimeIntervalType （3）
陣列	ArrayType	scala.collection.Seq	ArrayType（elementType [， containsNull]）。 (2)
地圖	MapType	scala.collection.Map	MapType（keyType， valueType [， valueContainsNull]）。 (2)
結構	StructType	org.apache.spark.sql.Row	StructType（fields）。 fields 是 StructField 的 Seq。 4.
	StructField	此欄位資料類型的實值型別（例如，StructField 的 Int 資料類型為 IntegerType）	StructField（name， dataType [， nullable]）。 4
變體	VariantType	org.apache.spark.unsafe.type.VariantVal	VariantType
物件	不支援	不支援	不支援

Java

Spark SQL 資料類型定義於封裝 org.apache.spark.sql.types中。 若要存取或建立數據類型，請使用 中 org.apache.spark.sql.types.DataTypes提供的 Factory 方法。

SQL 類型	資料類型	值類型	用來存取或建立數據類型的 API
TINYINT	ByteType	位元組或位元組	DataTypes.ByteType
SMALLINT	ShortType	short 或 Short	DataTypes.ShortType
INT	IntegerType	int 或 Integer	DataTypes.IntegerType
BIGINT	LongType	long 或 Long	DataTypes.LongType
FLOAT	FloatType	float 或 Float	DataTypes.FloatType
DOUBLE	DoubleType	double 或 Double	DataTypes.DoubleType
DECIMAL（p，s）	DecimalType	java.math.BigDecimal	DataTypes.createDecimalType（） DataTypes.createDecimalType（precision， scale）。
字串	StringType	String	DataTypes.StringType
二元的	BinaryType	byte[]	DataTypes.BinaryType
布爾	BooleanType	布爾值或布爾值	DataTypes.BooleanType
TIMESTAMP	TimestampType	java.sql.Timestamp	DataTypes.TimestampType
TIMESTAMP_NTZ	TimestampNTZType	java.time.LocalDateTime	DataTypes.TimestampNTZType
DATE	DateType	java.sql.Date	DataTypes.DateType
year-month interval	YearMonthIntervalType	java.time.Period	YearMonthIntervalType （3）
day-time interval	DayTimeIntervalType	java.time.Duration	DayTimeIntervalType （3）
陣列	ArrayType	ava.util.List	DataTypes.createArrayType（elementType [， containsNull]）。(2)
地圖	MapType	java.util.Map	DataTypes.createMapType（keyType， valueType [， valueContainsNull]）。(2)
結構	StructType	org.apache.spark.sql.Row	DataTypes.createStructType（fields）。 fields 是 StructField 的清單或陣列。 4
	StructField	此欄位資料類型的實值型別（例如，StructField 的 int 資料類型為 IntegerType）	DataTypes.createStructField（name， dataType， nullable） 4
變體	VariantType	org.apache.spark.unsafe.type.VariantVal	VariantType
物件	不支援	不支援	不支援

Python

Spark SQL 資料類型定義於封裝 pyspark.sql.types中。 您可以匯入套件來存取它們：

from pyspark.sql.types import *

SQL 類型	資料類型	值類型	用來存取或建立數據類型的 API
TINYINT	ByteType	int 或long。 (1)	ByteType（）
SMALLINT	ShortType	int 或long。 (1)	ShortType（）
INT	IntegerType	int 或long	IntegerType（）
BIGINT	LongType	long （1）	LongType（）
FLOAT	FloatType	float （1）	FloatType（）
DOUBLE	DoubleType	float	DoubleType（）
DECIMAL（p，s）	DecimalType	十進位。十進位	DecimalType（）
字串	StringType	字串	StringType（）
二元的	BinaryType	bytearray	BinaryType（）
布爾	BooleanType	bool	布林值類型（）
TIMESTAMP	TimestampType	datetime.datetime	TimestampType（）
TIMESTAMP_NTZ	TimestampNTZType	datetime.datetime	TimestampNTZType（）
DATE	DateType	datetime.date	DateType（）
year-month interval	YearMonthIntervalType	不支援	不支援
day-time interval	DayTimeIntervalType	datetime.timedelta	DayTimeIntervalType （3）
陣列	ArrayType	list、Tuple 或 array	ArrayType（elementType，[containsNull]）。(2)
地圖	MapType	dict	MapType（keyType，valueType，[valueContainsNull]）。(2)
結構	StructType	list 或 Tuple	StructType（fields）。 field 是 StructField 的 Seq。 (4)
	StructField	此欄位資料類型的實值型別 （例如，StructField 的 Int 資料類型為 IntegerType）	StructField（name， dataType， [nullable]]。(4)
變體	VariantType	VariantVal	VariantType（）
物件	不支援	不支援	不支援

R

SQL 類型	資料類型	值類型	用來存取或建立數據類型的 API
TINYINT	ByteType	整數 （1）	'byte'
SMALLINT	ShortType	整數 （1）	'short'
INT	IntegerType	整數	'integer'
BIGINT	LongType	整數 （1）	'long'
FLOAT	FloatType	numeric （1）	'float'
DOUBLE	DoubleType	numeric	'double'
DECIMAL（p，s）	DecimalType	不支援	不支援
字串	StringType	character	'string'
二元的	BinaryType	raw	'binary'
布爾	BooleanType	logical	'bool'
TIMESTAMP	TimestampType	POSIXct	'timestamp'
TIMESTAMP_NTZ	TimestampNTZType	datetime.datetime	TimestampNTZType（）
DATE	DateType	Date	'date'
year-month interval	YearMonthIntervalType	不支援	不支援
day-time interval	DayTimeIntervalType	不支援	不支援
陣列	ArrayType	向量或清單	list（type='array'， elementType=elementType， containsNull=[containsNull]）。(2)
地圖	MapType	environment	list（type='map'， keyType=keyType， valueType=valueType， valueContainsNull=[valueContainsNull]）。(2)
結構	StructType	具名清單	list（type='struct'， fields=fields）。 fields 是 StructField 的 Seq。 (4)
	StructField	此欄位資料類型的實值型別（例如，StructField 的整數資料類型為 IntegerType）	list（name=name， type=dataType， nullable=[nullable]）。(4)
變體	不支援	不支援	不支援
物件	不支援	不支援	不支援

（1） 數位會在運行時間轉換成網域。 請確定數位在範圍內。

（2） 選擇性值預設為 TRUE。

（3） 間隔類型

• YearMonthIntervalType([startField,] endField)：表示由下列欄位連續子集所組成的年月間隔：

  startField 是最左邊的欄位，而 endField 是類型最右邊的欄位。 與 endField 0(MONTH) 有效值為 startField 與 1(YEAR)。

• DayTimeIntervalType([startField,] endField)：表示由下列欄位連續子集所組成的日時間間隔：

  startField 是最左邊的欄位，而 endField 是類型最右邊的欄位。 和 endField 的有效值為 startField 、、1(HOUR)、 2(MINUTE)3(SECOND)。0(DAY)

（4） StructType

• StructType(fields) 表示具有序列、清單或 StructFields 陣列所描述之結構的值（欄位）。 不允許有兩個具有相同名稱的欄位。
• StructField(name, dataType, nullable) 表示中的 StructType欄位。 功能變數名稱會以 name表示。 欄位的數據類型會以 dataType 表示。 nullable 指出這些欄位的值是否可以有 null 值。 這是預設值。

相關文章

• 特殊浮點值