`TIMESTAMP_NTZ` type

Artikel
04/26/2024

Berlaku untuk: centang ditandai ya Databricks SQL Databricks Runtime 13.3 LTS ke atas

Mewakili nilai yang terdiri dari nilai bidang tahun, bulan, hari, jam, menit, dan detik. Semua operasi dilakukan tanpa memperhitungkan zona waktu apa pun.

Fitur ini ada di Pratinjau Publik. Lihat bagian Catatan untuk fitur yang tidak didukung.

Untuk menggunakan fitur ini di Delta Lake, Anda harus mengaktifkan dukungan untuk tabel. Dukungan fitur diaktifkan secara otomatis saat Anda membuat tabel Delta baru dengan kolom jenis TIMESTAMP_NTZ . Ini tidak diaktifkan secara otomatis saat Anda menambahkan kolom jenis TIMESTAMP_NTZ ke tabel yang sudah ada. Untuk mengaktifkan dukungan untuk TIMESTAMP_NTZ kolom, dukungan untuk fitur harus diaktifkan secara eksplisit untuk tabel yang ada.

Mengaktifkan dukungan meningkatkan protokol tabel Anda. Lihat Bagaimana Azure Databricks mengelola kompatibilitas fitur Delta Lake?. Perintah berikut mengaktifkan fitur ini:

ALTER TABLE table_name SET TBLPROPERTIES ('delta.feature.timestampNtz' = 'supported')

Sintaks

TIMESTAMP_NTZ

Batas

Rentang stempel waktu yang didukung adalah -290308-12-21 BCE 19:59:06 hingga +294247-01-10 CE 04:00:54.

Harfiah

TIMESTAMP_NTZ timestampString

timestampString
{ '[+|-]yyyy[...]' |
  '[+|-]yyyy[...]-[m]m' |
  '[+|-]yyyy[...]-[m]m-[d]d' |
  '[+|-]yyyy[...]-[m]m-[d]d ' |
  '[+|-]yyyy[...]-[m]m-[d]d[T][h]h[:]' |
  '[+|-]yyyy[..]-[m]m-[d]d[T][h]h:[m]m[:]' |
  '[+|-]yyyy[...]-[m]m-[d]d[T][h]h:[m]m:[s]s[.]' |
  '[+|-]yyyy[...]-[m]m-[d]d[T][h]h:[m]m:[s]s.[ms][ms][ms][us][us][us]' }

+ atau -: Tanda opsional. - menunjukkan BCE, + menunjukkan CE (default).
yyyy: Setahun yang terdiri dari setidaknya empat digit.
[m]m: Satu atau dua digit bulan antara 01 hingga 12.
[d]d: Satu atau dua digit hari antara 01 hingga 31.
h[h]: Satu atau dua digit jam antara 00 hingga 23.
m[m]: Satu atau dua digit menit antara 00 hingga 59.
s[s]: Satu atau dua digit menit antara 00 hingga 59.
[ms][ms][ms][us][us][us]: Hingga 6 digit pecahan detik.

Jika komponen bulan atau hari tidak ditentukan, komponen tersebut default ke 1. Jika komponen jam, menit, atau detik tidak ditentukan, komponen tersebut default ke 0.

Jika literal tidak mewakili tanda waktu yang tepat Azure Databricks menimbulkan kesalahan.

Catatan

Jenis saat TIMESTAMP_NTZ ini belum didukung di:
- Foton
- Berbagi Delta
- Sumber data Databricks yang digunakan di driver Power BI, Tableau, Databricks JDBC/ODBC, atau Databricks sumber terbuka.
TIMESTAMP_NTZ jenis didukung dalam sumber file termasuk Delta/Parquet/ORC/AVRO/JSON/CSV. Namun, ada batasan pada inferensi skema untuk file JSON/CSV dengan kolom TIMESTAMP_NTZ. Untuk kompatibilitas mundur, jenis tanda waktu default yang disimpulkan dari spark.read.csv(...) atau spark.read.json(...) akan menjadi jenis TIMESTAMP alih-alih TIMESTAMP_NTZ.

Contoh

> SELECT TIMESTAMP_NTZ'0000';
  0000-01-01 00:00:00

> SELECT TIMESTAMP_NTZ'2020-12-31';
  2020-12-31 00:00:00

> SELECT TIMESTAMP_NTZ'2021-7-1T8:43:28.123456';
  2021-07-01 08:43:28.123456

> SELECT current_timezone(), CAST(TIMESTAMP '2021-7-1T8:43:28' as TIMESTAMP_NTZ);
  America/Los_Angeles 2021-07-01 08:43:28

> SELECT CAST('1908-03-15 10:1:17' AS TIMESTAMP_NTZ)
  1908-03-15 10:01:17

> SELECT TIMESTAMP_NTZ'+10000';
  +10000-01-01 00:00:00

TIMESTAMP_NTZ type