عبارة 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_constraintPRIMARY 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_constraintFOREIGN 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);