ALTER TABLE عبارة COLUMN

ينطبق على: Databricks SQL Databricks Runtime

إضافة عمود أو تعديله أو إسقاطه في جدول أو حقل في عمود في جدول Delta Lake.

الأذونات المطلوبة

إذا كنت تستخدم كتالوج Unity، يجب أن يكون لديك MODIFY إذن ل:

• تغيير العمود
• إضافة عمود
• إسقاط عمود

تتطلب جميع العمليات الأخرى ملكية الجدول.

بناء الجملة

ALTER TABLE table_name
   { ADD COLUMN clause |
     ALTER COLUMN clause |
     DROP COLUMN clause |
     RENAME COLUMN clause }

عبارة ADD COLUMN

هذه العبارة غير معتمدة لمصادر JDBC البيانات.

إضافة عمود واحد أو أكثر إلى الجدول، أو حقول إلى أعمدة موجودة في جدول Delta Lake.

إشعار

عند إضافة عمود إلى جدول Delta موجود، لا يمكنك تعريف DEFAULT قيمة. يتم التعامل مع جميع الأعمدة المضافة إلى جداول Delta على أنها NULL للصفوف الموجودة. بعد إضافة عمود، يمكنك تحديد قيمة افتراضية للعمود بشكل اختياري، ولكن يتم تطبيق ذلك فقط على الصفوف الجديدة المدرجة في الجدول. استخدم بناء الجملة التالي:

ALTER TABLE table_name ALTER COLUMN column_name SET DEFAULT default_expression

بناء الجملة

{ ADD [ COLUMN | COLUMNS ]
  ( { { column_identifier | field_name } data_type
      [ DEFAULT clause ] [ COMMENT comment ] [ FIRST | AFTER identifier ]
      [ MASK clause ] } [, ...] ) }

المعلمات

• column_identifier

  اسم العمود المراد إضافته. يجب أن يكون الاسم فريدا داخل الجدول.

  سيتم إلحاق العمود أو الحقل في النهاية ما لم FIRST AFTER name يتم تحديدهما.

• field_name

  الاسم المؤهل بالكامل للحقل المراد إضافته إلى عمود موجود. يجب أن تكون كافة مكونات المسار إلى الحقل المتداخل موجودة ويجب أن يكون اسم الحقل نفسه فريدا.

• DEFAULT default_expression

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

  DEFAULT تعريف قيمة للعمود الذي يتم استخدامه في INSERT وعندما MERGE ... INSERT لا يتم تحديد العمود.

  إذا لم يتم تحديد أي افتراضي، DEFAULT NULL يتم تضمينه للأعمدة التي تقبل القيم الخالية.

  default_expression قد تتكون من القيم الحرفية، ووظائف SQL المضمنة أو عوامل التشغيل باستثناء:

  • دالات التجميع
  • دوال النافذة التحليلية
  • دالات نافذة تحديد المرتبة
  • دالات مولد قيم الجدول

  default_expression يجب ألا يحتوي على أي طلب فرعي.

  DEFAULTمعتمد للمصادر CSVJSONPARQUETو و.ORC

• data_type

  تحديد نوع بيانات العمود أو الحقل. لا تدعم جميع مصادر البيانات جميع أنواع البيانات التي يدعمها Azure Databricks.

• COMMENT comment

  قيمة حرفية اختيارية STRING تصف العمود أو الحقل المضاف.

  إذا كنت تريد إضافة تعليق تم إنشاؤه الذكاء الاصطناعي لعمود جدول أو جدول مدار بواسطة كتالوج Unity، فشاهد إضافة تعليقات تم إنشاؤها الذكاء الاصطناعي إلى كائنات كتالوج Unity.

• FIRST

  إذا تم تحديد العمود، فستتم إضافة العمود كأول عمود في الجدول، أو ستتم إضافة الحقل كالحقول الأولى في البنية التي تحتوي عليها.

• AFTERمعرف

  إذا تم تحديد العمود أو الحقل، ستتم إضافته مباشرة بعد الحقل أو العمود identifier.

• عبارة MASK

  ينطبق على: Databricks SQL Databricks Runtime 12.2 LTS وما فوق كتالوج Unity فقط

  هام

  هذه الميزة في المعاينة العامة.

  إضافة دالة قناع عمود إلى إخفاء البيانات الحساسة. ستتلقى جميع الاستعلامات اللاحقة من هذا العمود نتيجة تقييم تلك الدالة فوق العمود بدلا من القيمة الأصلية للعمود. يمكن أن يكون هذا مفيدا لأغراض التحكم في الوصول الدقيقة حيث يمكن للدالة فحص هوية المستخدم الذي يستدعي أو عضويات المجموعة لتحديد ما إذا كان يجب تنقيح القيمة أم لا.

عبارة ALTER COLUMN

ينطبق على: Databricks SQL Databricks Runtime

تغيير خاصية أو موقع عمود.

بناء الجملة

{ { ALTER | CHANGE } [ COLUMN ] { column_identifier | field_name }
  { COMMENT comment |
    { FIRST | AFTER column_identifier } |
    { SET | DROP } NOT NULL |
    TYPE data_type |
    SET DEFAULT clause |
    DROP DEFAULT |
    SYNC IDENTITY |
    SET { MASK clause } |
    DROP MASK |
    SET TAGS clause |
    UNSET TAGS clause } }

المعلمات

• column_identifier

  اسم العمود المراد تغييره.

• field_name

  الاسم المؤهل بالكامل للحقل المراد تغييره. يجب أن تكون كافة مكونات المسار إلى الحقل المتداخل موجودة.

• COMMENT comment

  تغيير وصف column_name العمود. comment يجب أن تكون قيمة حرفية STRING .

• FIRST أو AFTERالمعرف

  نقل العمود من موضعه الحالي إلى الأمام (FIRST) أو على الفور AFTER identifier. يتم اعتماد هذه العبارة فقط إذا كان table_name جدول Delta.

• TYPEdata_type

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

  تغيير نوع column_name بيانات العمود.

  يتم اعتماد هذه العبارة فقط إذا كان table_name جدول Delta.

  يتم اعتماد تغييرات النوع التالية لكافة جداول Delta:

  • زيادة حجم VARCHAR عمود، على سبيل المثال، من VARCHAR(5) إلى VARCHAR(10)
  • تغيير نوع CHAR العمود إلى VARCHAR، على سبيل المثال، من CHAR(5) إلى VARCHAR(5)
  • تغيير نوع CHAR VARCHAR أو عمود إلى STRING، على سبيل المثال، من VARCHAR(10) إلى STRING.

  يتم اعتماد تغييرات النوع التالية لجداول Delta مع delta.enableTypeWidening تعيين إلى true:

  هام

  هذه الميزة موجودة في المعاينة العامة في Databricks Runtime 15.2 وما فوق.

  نوع المصدر	أنواع أوسع مدعومة
  BYTE	SHORT، INT، BIGINT، ، DECIMALDOUBLE
  SHORT	INT، ، BIGINT، DECIMALDOUBLE
  INT	BIGINT، ، DECIMALDOUBLE
  BIGINT	DECIMAL, DOUBLE
  FLOAT	DOUBLE
  DECIMAL	DECIMAL بمزيد من الدقة والحجم
  DATE	TIMESTAMP_NTZ

  لمزيد من المعلومات التفصيلية حول توسيع النوع، راجع توسيع النوع.

• SET NOT NULL أو DROP NOT NULL

  تغيير مجال قيم الأعمدة الصالحة لاستبعاد القيم الخالية SET NOT NULL، أو تضمين القيم الخالية DROP NOT NULL. هذا الخيار معتمد فقط لجداول Delta Lake. سيضمن Delta Lake أن القيد صالح لجميع البيانات الموجودة والجديدة.

• SYNC IDENTITY

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

  مزامنة بيانات التعريف لعمود الهوية مع البيانات الفعلية. عند كتابة القيم الخاصة بك إلى عمود هوية، قد لا يتوافق مع بيانات التعريف. يقوم هذا الخيار بتقييم الحالة وتحديث بيانات التعريف لتكون متسقة مع البيانات الفعلية. بعد هذا الأمر، ستبدأ قيمة الهوية المعينة تلقائيا التالية من start + (n + 1) * step، حيث n تكون أصغر قيمة تفي start + n * step >= max() بها (لخطوة إيجابية).

  هذا الخيار مدعوم فقط لأعمدة الهوية في جداول Delta Lake.

• DROP DEFAULT

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

  إزالة التعبير الافتراضي من العمود. بالنسبة للأعمدة التي تقبل القيم الخالية، يكون هذا مكافئا ل SET DEFAULT NULL. بالنسبة للأعمدة المعرفة بهاNOT NULL، تحتاج إلى توفير قيمة في كل عملية مستقبلية INSERT

• SET DEFAULT default_expression

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

  DEFAULT تعريف قيمة للعمود الذي يتم استخدامه في INSERT وعندما MERGE ... INSERT لا يتم تحديد العمود.

  إذا لم يتم DEFAULT NULL تحديد أي افتراضي، تضمينه للأعمدة التي تقبل القيم الخالية.

  default_expression قد تتكون من قيم حرفية أو دالات SQL مضمنة أو عوامل تشغيل باستثناء:

  • دالات التجميع
  • دوال النافذة التحليلية
  • دالات نافذة تحديد المرتبة
  • دالات مولد قيم الجدول

  default_expression يجب ألا يحتوي على الاستعلام الفرعي.

  DEFAULTمعتمد للمصادر CSVJSONORCو و.PARQUET

  عند تعريف الإعداد الافتراضي لعمود تمت إضافته حديثا، ينطبق الإعداد الافتراضي على كافة الصفوف الموجودة مسبقا. إذا كان الافتراضي يتضمن دالة غير محددة مثل rand أو current_timestamp يتم حساب القيمة مرة واحدة عند ALTER TABLE تنفيذ ، وتطبيقها كثابت على الصفوف الموجودة مسبقا. بالنسبة للصفوف المدرجة حديثا، يتم تشغيل التعبير الافتراضي مرة واحدة لكل صف.

  عند تعيين افتراضي باستخدام ALTER COLUMN، لا تتأثر الصفوف الموجودة بهذا التغيير.

• SETعبارة MASK

  ينطبق على: Databricks SQL Databricks Runtime 12.2 LTS وما فوق كتالوج Unity فقط

  هام

  هذه الميزة في المعاينة العامة.

  إضافة دالة قناع عمود إلى إخفاء البيانات الحساسة. ستتلقى جميع الاستعلامات اللاحقة من هذا العمود نتيجة تقييم تلك الدالة فوق العمود بدلا من القيمة الأصلية للعمود. يمكن أن يكون هذا مفيدا لأغراض التحكم في الوصول الدقيقة حيث يمكن للدالة فحص هوية المستخدم الذي يستدعي أو عضويات المجموعة لتحديد ما إذا كان يجب تنقيح القيمة أم لا.

• DROP MASK

  ينطبق على: كتالوج Unity فقط

  هام

  هذه الميزة في المعاينة العامة.

  إزالة قناع العمود لهذا العمود، إن وجد. ستتلقى الاستعلامات المستقبلية من هذا العمود القيم الأصلية للعمود.

• SET TAGS ( { tag_name = tag_value } [, ...] )

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

  تطبيق العلامات على العمود. تحتاج إلى إذن APPLY TAG لإضافة علامات إلى العمود.

  • tag_name

    قيمة حرفية STRING. tag_name يجب أن يكون فريدا داخل الجدول أو العمود.

  • tag_value

    قيمة حرفية STRING.

• UNSET TAGS ( tag_name [, ...] )

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

  إزالة العلامات من العمود. يجب أن يكون لديك APPLY TAG إذن لإزالة العلامات من العمود.

  • tag_name

    قيمة حرفية STRING. tag_name يجب أن يكون فريدا داخل الجدول أو العمود.

عبارة DROP COLUMN

هام

هذه الميزة في المعاينة العامة.

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

إسقاط عمود أو حقل واحد أو أكثر في جدول Delta Lake.

عند إسقاط عمود أو حقل، يجب إسقاط قيود التحقق التابعة والأعمدة التي تم إنشاؤها.

للحصول على المتطلبات، راجع إعادة تسمية الأعمدة وإفلاتها باستخدام تعيين عمود Delta Lake.

بناء الجملة

DROP [COLUMN | COLUMNS] [ IF EXISTS ] ( { {column_identifier | field_name} [, ...] )

المعلمات

• IF EXISTS

  عند تحديد IF EXISTS، يتجاهل Azure Databricks محاولة إسقاط الأعمدة غير الموجودة. وإلا، سيؤدي إسقاط الأعمدة غير الموجودة إلى حدوث خطأ.

• column_identifier

  اسم العمود الموجود.

• field_name

  الاسم المؤهل بالكامل لحقل موجود.

عبارة RENAME COLUMN

هام

هذه الميزة في المعاينة العامة.

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

إعادة تسمية عمود أو حقل في جدول Delta Lake ممكن لتعيين العمود.

عند إعادة تسمية عمود أو حقل، تحتاج أيضا إلى تغيير قيود التحقق التابعة والأعمدة التي تم إنشاؤها. سيتم إسقاط أي مفاتيح أساسية ومفاتيح خارجية تستخدم العمود. في حالة وجود مفاتيح خارجية، يجب أن تمتلك الجدول الذي يتم تعريف المفتاح الخارجي عليه.

للحصول على المتطلبات، وكيفية تمكين تعيين العمود، راجع إعادة تسمية الأعمدة وإفلاتها باستخدام تعيين عمود Delta Lake.

بناء الجملة

RENAME COLUMN { column_identifier TO to_column_identifier|
                field_name TO to_field_identifier }

المعلمات

• column_identifier

  الاسم الموجود للعمود.

• to_column_identifier

  معرف العمود الجديد. يجب أن يكون المعرف فريدا داخل الجدول.

• field_name

  الاسم المؤهل بالكامل للحقل الموجود.

• to_field_identifier

  معرف الحقل الجديد. يجب أن يكون المعرف فريدا داخل البنية المحلية.

الأمثلة

راجع أمثلة ALTER TABLE.

المقالات ذات الصلة

• ALTER TABLE
• توسيع النوع