مشاركة عبر

ALTER TABLE قسم

  • مقالة

ينطبق على: وضع علامة Databricks SQL وضع علامة Databricks Runtime

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

إدارة الأقسام غير معتمدة لجداول Delta Lake.

بناء الجملة

ALTER TABLE table_name
   { ADD PARTITION clause |
     DROP PARTITION clause |
     PARTITION SET LOCATION clause |
     RENAME PARTITION clause |
     RECOVER PARTITIONS clause }

ADD PARTITION بند

إضافة قسم واحد أو أكثر إلى الجدول.

بناء الجملة

ADD [IF NOT EXISTS] { PARTITION clause [ LOCATION path ] } [...]

المعلمات

  • IF NOT EXISTS

    عبارة اختيارية توجه Azure Databricks لتجاهل العبارة إذا كان القسم موجودا بالفعل.

  • عبارة PARTITION

    قسم ستتم إضافته. يجب أن تتطابق مفاتيح الأقسام مع تقسيم الجدول وأن تكون مقترنة بالقيم. إذا كان القسم موجودا بالفعل، يتم رفع خطأ ما لم IF NOT EXISTS يتم تحديده.

  • LOCATION path

    path يجب أن تكون STRING قيمة حرفية تمثل موقعا اختياريا يشير إلى القسم.

    إذا لم يتم تحديد أي موقع، اشتقاق الموقع من موقع الجدول ومفاتيح الأقسام.

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

DROP PARTITION بند

يسقط قسما واحدا أو أكثر من الجدول، ويحذف اختياريا أي ملفات في مواقع الأقسام.

بناء الجملة

DROP [ IF EXISTS ] PARTITION clause [, ...] [PURGE]

المعلمات

  • IF EXISTS

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

  • عبارة PARTITION

    تحديد قسم ليتم إسقاطه. إذا تم تحديد القسم جزئيا فقط، يتم إسقاط شريحة من الأقسام.

  • PURGE

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

    يدعم نظام الملفات مجلد سلة المهملات. تم تكوين الكتالوج لنقل القسم الذي تم إسقاطه إلى مجلد سلة المهملات. لا يوجد مجلد سلة المهملات في AWS S3، لذلك فهو غير فعال.

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

RENAME PARTITION بند

استبدال مفاتيح القسم.

بناء الجملة

from_partition_clause RENAME TO to_partition_clause

المعلمات

  • from_partition_clause

    تعريف القسم المراد إعادة تسميته.

  • to_partition_clause

    التعريف الجديد لهذا القسم. يجب ألا يكون القسم الذي له نفس المفاتيح موجودا بالفعل.

RECOVER PARTITIONS بند

لا تنطبق هذه العبارة على جداول Delta Lake.

يرشد Azure Databricks إلى مسح موقع الجدول ضوئيا وإضافة أي ملفات إلى الجدول التي تمت إضافتها مباشرة إلى نظام الملفات.

بناء الجملة

RECOVER PARTITIONS

المعلمات

بلا

عبارة PARTITION SET LOCATION

نقل موقع القسم.

بناء الجملة

PARTITION clause SET LOCATION path

المعلمات

  • عبارة PARTITION

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

  • LOCATION path

    path يجب أن تكون قيمة حرفية STRING . تحديد الموقع الجديد للقسم.

    لن يتم نقل الملفات الموجودة في الموقع الأصلي إلى الموقع الجديد.

الأمثلة

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