عبارة CONSTRAINT
ينطبق على: Databricks SQL Databricks Runtime
إضافة مفتاح أساسي إعلامي أو مفتاح خارجي إعلامية كجزء من عبارة CREATE TABLE أو CREATE MATERIALIZED VIEW .
لإضافة قيد فحص إلى جدول Delta Lake، استخدم ALTER TABLE بعد إنشاء الجدول.
بناء الجملة
table_constraint
استخدم عبارة لتعريف القيود التي تمتد عبر أعمدة متعددة أو لفصل بناء الجملة بعيدا عن تعريف العمود.
table_constraint
{ [ CONSTRAINT name ]
{ PRIMARY KEY ( key_column [ TIMESERIES ] [, ...] ) [ constraint_option [...] ] |
{ FOREIGN KEY ( foreign_key_column [, ...] )
REFERENCES parent_table [ ( parent_column [, ...] ) ]
[ foreign_key_option | constraint_option ] [...]
}
}
}
column_constraint
استخدم عبارة لتعريف القيود الخاصة بتعريف عمود واحد.
column_constraint
{ [ CONSTRAINT name ]
{ PRIMARY KEY [ constraint_option ] [...] |
{ [ FOREIGN KEY ]
REFERENCES parent_table [ ( parent_column [, ...] ) ]
[ foreign_key_option | constraint_option ] [...]
}
}
}
constraint_option
{ NOT ENFORCED |
DEFERRABLE |
INITIALLY DEFERRED |
{ RELY | NORELY } }
foreign_key_option
{ MATCH FULL |
ON UPDATE NO ACTION |
ON DELETE NO ACTION }
للتوافق مع لهجات SQL غير القياسية، يمكنك تحديد ENABLE NOVALIDATE
بدلا من NOT ENFORCED DEFERRABLE INITIALLY DEFERRED
.
المعلمات
CONSTRAINT
الاسميحدد اختياريا اسما للقيد. يجب أن يكون الاسم فريدا داخل المخطط. إذا لم يتم توفير أي اسم، فسينشئ Azure Databricks اسما.
PRIMARY KEY
( key_column [ TIMESERIES ] [, ...] ) [ constraint_option [...] ]ينطبق على: Databricks SQL Databricks Runtime 11.3 LTS وما فوق كتالوج Unity فقط
إضافة قيد مفتاح أساسي إعلامي إلى الجدول أو طريقة العرض المجسدة. يمكن أن يحتوي الجدول أو طريقة العرض المجسدة على مفتاح أساسي واحد على الأكثر.
يتم تعريف أعمدة المفتاح الأساسي ضمنيا على أنها
NOT NULL
.قيود المفتاح الأساسي غير معتمدة للجداول في الكتالوج
hive_metastore
.-
عمود جدول الموضوع أو طريقة العرض المجسدة. يجب عدم تكرار أسماء الأعمدة.
TIMESERIES
ينطبق على: Databricks SQL Databricks Runtime 13.3 LTS وما فوق
يقوم اختياريا بتسمية مكون عمود المفتاح الأساسي على أنه يمثل أوقاتا.
-
PRIMARY KEY [ constraint_option ] [...]
إضافة قيد مفتاح أساسي لعمود واحد إلى الجدول أو طريقة العرض المجسدة، باستخدام تعريف عمود المفتاح السابق.
وهذا
column_constraint
يعادلtable_constraint
PRIMARY KEY (key_column) [ constraint_option ] [...]
FOREIGN KEY (foreign_key_column [, ...] ) REFERENCES parent_table [ ( parent_column [, ...] ) ] foreign_key_option
ينطبق على: Databricks SQL Databricks Runtime 11.3 LTS وما فوق كتالوج Unity فقط
إضافة قيد مفتاح خارجي معلوماتي (التكامل المرجعي) إلى الجدول أو طريقة العرض المجسدة.
قيود المفتاح الخارجي غير معتمدة للجداول في الكتالوج
hive_metastore
.لا يسمح بقيود المفتاح الخارجي التي تختلف فقط في تباديل أعمدة المفتاح الخارجي.
-
عمود جدول الموضوع أو طريقة العرض المجسدة. يجب عدم تكرار أسماء الأعمدة. يجب أن يتطابق نوع بيانات كل عمود مع نوع المطابقة
parent_column
. يجب أن يتطابق عدد الأعمدة مع عدد الأعمدةparent_column
. يتعذر على مفتاحين خارجيين مشاركة مجموعة متطابقة من أعمدة المفاتيح الخارجية. -
تحديد الجدول أو طريقة العرض المجسدة التي يشير إليها المفتاح الخارجي. يجب أن يحتوي الجدول على قيد محدد
PRIMARY KEY
، ويجب أن يكون لديك الامتيازSELECT
على الجدول. -
عمود في الجدول الأصل أو طريقة العرض المجسدة التي تعد جزءا من مفتاحه الأساسي. يجب إدراج كافة أعمدة المفتاح الأساسي للجدول الأصل أو طريقة العرض المجسدة.
إذا لم تكن الأعمدة الأصل مدرجة، يتم تحديدها بالترتيب المحدد في
PRIMARY KEY
التعريف. FOREIGN KEY REFERENCES parent_table [ ( parent_column ) ] foreign_key_option
إضافة قيد مفتاح خارجي لعمود واحد إلى الجدول أو طريقة العرض المجسدة، باستخدام تعريف عمود المفتاح الخارجي السابق.
وهذا
column_constraint
يعادلtable_constraint
FOREIGN KEY ( foreign_key_column ) REFERENCES parent_table [ ( parent_column ) ] foreign_key_option
-
constraint_option
يسرد خصائص القيود. جميع الخصائص اختيارية ولكنها ضمنية بشكل افتراضي. يمكن تحديد كل خاصية مرة واحدة على الأكثر.
NOT ENFORCED
لا يتخذ Azure Databricks أي إجراء لفرضه للصفوف الموجودة أو الجديدة.
DEFERRABLE
يمكن تأجيل فرض القيد.
INITIALLY DEFERRED
يتم تأجيل فرض القيد.
NORELY
أوRELY
ينطبق على: Databricks SQL Databricks Runtime 14.2 والإصدارات الأحدث للقيود
PRIMARY KEY
ينطبق على: Databricks Runtime 15.4 والإصدارات الأحدث للقيود
FOREIGN KEY
إذا ،
RELY
فقد يستغل Azure Databricks القيد لإعادة كتابة الاستعلامات. تقع على عاتق المستخدم مسؤولية التأكد من استيفاء القيد. قد يؤدي الاعتماد على قيد غير راض إلى نتائج استعلام غير صحيحة.الافتراضي هو
NORELY
.
foreign_key_option
يسرد الخصائص الخاصة بقيود المفتاح الخارجي. جميع الخصائص اختيارية ولكنها ضمنية بشكل افتراضي. يمكن تحديد كل خاصية مرة واحدة على الأكثر.
MATCH FULL
لكي يعتبر القيد صحيحا، يجب أن تكون
NOT NULL
كافة قيم الأعمدة .ON UPDATE NO ACTION
إذا تم تحديث الأصل
PRIMARY KEY
، لا يتخذ Azure Databricks أي إجراء لتقييد التحديث أو تحديث المفتاح الخارجي.ON DELETE NO ACTION
إذا تم حذف الصف الأصل، فلن يتخذ Azure Databricks أي إجراء لتقييد الإجراء أو تحديث المفتاح الخارجي أو حذف الصف التابع.
هام
لا يفرض Azure Databricks قيود المفتاح الأساسي أو المفتاح الخارجي. قم بتأكيد قيود المفتاح قبل إضافة مفتاح أساسي أو خارجي. قد توفر عملية استيعابك مثل هذا الضمان، أو يمكنك تشغيل عمليات التحقق مقابل بياناتك.
الأمثلة
-- Create a table with a primary key
> CREATE TABLE persons(first_name STRING NOT NULL, last_name STRING NOT NULL, nickname STRING,
CONSTRAINT persons_pk PRIMARY KEY(first_name, last_name));
-- create a table with a foreign key
> CREATE TABLE pets(name STRING, owner_first_name STRING, owner_last_name STRING,
CONSTRAINT pets_persons_fk FOREIGN KEY (owner_first_name, owner_last_name) REFERENCES persons);
-- Create a table with a single column primary key and system generated name
> CREATE TABLE customers(customerid STRING NOT NULL PRIMARY KEY, name STRING);
-- Create a table with a names single column primary key and a named single column foreign key
> CREATE TABLE orders(orderid BIGINT NOT NULL CONSTRAINT orders_pk PRIMARY KEY,
customerid STRING CONSTRAINT orders_customers_fk REFERENCES customers);