TIMESTAMP_NTZ نوع

ينطبق على: Databricks SQL Databricks Runtime 13.3 LTS وما فوق

يمثل القيم التي تتضمن قيم الحقول السنة والشهر واليوم والساعة والدقيقة والثانية. يتم تنفيذ جميع العمليات دون أخذ أي منطقة زمنية في الاعتبار.

هذه الميزة في المعاينة العامة. راجع قسم الملاحظات للاطلاع على الميزات غير المدعومة.

لاستخدام هذه الميزة على Delta Lake، يجب تمكين دعم الجدول. يتم تمكين دعم الميزة تلقائيا عند إنشاء جدول Delta جديد بعمود من TIMESTAMP_NTZ النوع. لا يتم تمكينه تلقائيا عند إضافة عمود من TIMESTAMP_NTZ النوع إلى جدول موجود. لتمكين دعم TIMESTAMP_NTZ الأعمدة، يجب تمكين دعم الميزة بشكل صريح للجدول الموجود.

يؤدي تمكين الدعم إلى ترقية بروتوكول الجدول. راجع كيف تدير Azure Databricks توافق ميزة Delta Lake؟. يتيح الأمر التالي هذه الميزة:

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

بناء الجملة

TIMESTAMP_NTZ

الحدود

نطاق الطوابع الزمنية المدعومة هو -290308-12-21 BCE 19:59:06 إلى +294247-01-10 CE 04:00:54.

القيم الحرفية

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]' }

• + أو -: علامة اختيارية. - يشير إلى BCE، + ويشير إلى CE (افتراضي).
• yyyy: سنة تتكون من أربعة أرقام على الأقل.
• [m]m: شهر واحد أو رقمين بين 01 و12.
• [d]d: يوم واحد أو رقمين بين 01 و31.
• h[h]: ساعة واحدة أو رقمين بين 00 و23.
• m[m]: دقيقة أو رقمين بين 00 و59.
• s[s]: ثانية واحدة أو رقمين بين 00 و59.
• [ms][ms][ms][us][us][us]: ما يصل إلى 6 أرقام من الثوان الكسرية.

إذا لم يتم تحديد مكونات الشهر أو اليوم، فسيتم تعيينها افتراضيا إلى 1. إذا لم يتم تحديد مكونات الساعة أو الدقيقة أو الثانية فهي افتراضية إلى 0.

إذا كانت القيمة الحرفية لا تمثل طابعا زمنيا مناسبا، فإن Azure Databricks يثير خطأ.

ملاحظات

• النوع حاليا TIMESTAMP_NTZ غير مدعوم بعد في:
  • الفوتون
  • مشاركة دلتا
  • مصادر بيانات Databricks المستخدمة في برامج تشغيل Power BI أو Tableau أو Databricks JDBC/ODBC أو برامج تشغيل مصدر مفتوح Databricks.
• TIMESTAMP_NTZ النوع مدعوم في مصادر الملفات بما في ذلك Delta/Parquet/ORC/AVRO/JSON/CSV. ومع ذلك، هناك قيود على استنتاج المخطط لملفات JSON/CSV مع أعمدة TIMESTAMP_NTZ. للتوافق مع الإصدارات السابقة، يكون نوع الطابع الزمني الافتراضي المستنتج من spark.read.csv(...) أو spark.read.json(...) سيكون نوع TIMESTAMP بدلا من TIMESTAMP_NTZ.

الأمثلة

> 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

مرتبط‬

• نوع الطابع الزمني
• نوع التاريخ
• نوع الفاصل الزمني
• الدالة cast