عرض مصدر SQL/alter table

<noinclude>{{DISPLAYTITLE:تعديل الجدول ALTER TABLE}}</noinclude>
يُستخدَم هذا الأمر لتعديل تعريف الجدول المُنشأ مسبقًا عبر الأمر <code>[[SQL/create table|CREATE TABLE]]</code>، وله الصيغ الآتية:<syntaxhighlight lang="sql">
ALTER TABLE [ IF EXISTS ] name
    RENAME [ COLUMN ] col_name TO new_col_name

</syntaxhighlight>لإعادة تسمية عمود اسمه <code>col_name</code> في الجدول الذي اسمه <code>name</code> (إن وُجد) باسمٍ جديد <code>new_col_name</code>.<syntaxhighlight lang="sql">
ALTER TABLE [ IF EXISTS ] name 
    RENAME CONSTRAINT const_name TO new_const_name

</syntaxhighlight>لإعادة تسمية قيد اسمه <code>const_name</code> في الجدول الذي اسمه <code>name</code> (إن وُجد) باسمٍ جديد <code>new_const_name</code>.<syntaxhighlight lang="sql">
ALTER TABLE [ IF EXISTS ] name
    RENAME TO new_name

</syntaxhighlight>لإعادة تسمية الجدول الذي اسمه <code>name</code> (إن وُجد) باسمٍ جديد <code>new_name</code>.<syntaxhighlight lang="sql">
ALTER TABLE [ IF EXISTS ] name
    action [, ... ]

</syntaxhighlight>لتنفيذ تعديل على الجدول من بين التعديلات الآتية:
{| class="wikitable"
!التعديل المُنفّذ
!الشيفرة action
|-
|إضافة عمود جديد (إن لم يوجد مسبقًا) باسم <code>column_name</code> [[SQL/data types|وبنوع بيانات]] <code>data_type</code> وإضافة قيود له
|<code>ADD [ COLUMN ] [ IF NOT EXISTS ] column_name data_type [ column_constraint [ ... ] ]‎</code>
|-
|حذف عمود باسم <code>column_name</code> (إن وُجد) وتستخدم الكلمة المفتاحية <code>CASCADE</code> في حال وجود أي اعتماد على هذا العمود من أي عنصر آخر خارج الجدول (مثل حالة المفتاح الثانوي)
|<code>DROP [ COLUMN ] [ IF EXISTS ] column_name [CASCADE ]‎</code>
|-
|تعديل نوع البيانات بالعمود <code>column_name</code> ليصبح بنوع <code>data_type</code>
|<code>ALTER [ COLUMN ] column_name [ SET DATA ] TYPE data_type</code>
|-
|تعديل القيمة الافتراضية للعمود <code>column_name</code> لتصبح بقيمة <code>expression</code>
|<code>ALTER [ COLUMN ] column_name SET DEFAULT expression</code>
|-
|حذف القيمة الافتراضية الحالية للعمود <code>column_name</code>
|<code>ALTER [ COLUMN ] column_name DROP DEFAULT</code>
|-
|إضافة/حذف قيد ألا تكون القيمة خالية <code>NOT NULL</code> في العمود <code>column_name</code>
|<code><nowiki>ALTER [ COLUMN ] column_name { SET | DROP } NOT NULL</nowiki></code>
|-
|تعديل قيمة إحدى صفات <code>attribute_option</code> العمود <code>column_name</code> لتصبح <code>value</code>
|<code>ALTER [ COLUMN ] column_name SET ( attribute_option = value [, ... ] )‎</code>
|-
|إعادة ضبط قيمة إحدى صفات  <code>attribute_option</code> العمود <code>column_name</code> لتصبح القيمة الافتراضية
|<code>ALTER [ COLUMN ] column_name RESET ( attribute_option [, ... ] )‎</code>
|-
|إضافة قيد على مستوى الجدول
|<code>ADD table_constraint</code>
|-
|حذف القيد <code>constraint_name</code> (إن وُجد)
|<code>DROP CONSTRAINT [ IF EXISTS ]  constraint_name</code>
|-
|لتعديل أيّ من قيم معاملات التخزين المتعلقة بالجدول
|<code>SET ( storage_parameter = value [, ... ] )‎</code>
|-
|لإعادة ضبط قيمة أحد معاملات التخزين المتعلقة بالجدول
|<code>RESET ( storage_parameter [, ... ] )‎</code>
|-
|لنقل ملكية الجدول إلى مالك جديد new_owner أو المستخدم الحالي <code>CURRENT_USER</code>
|<code><nowiki>OWNER TO { new_owner | CURRENT_USER }‎</nowiki></code>
|}

== أمثلة ==
لإضافة عمود جديد إلى جدول الطلاب <code>students</code> باسم <code>address</code> يستخدم الأمر الآتي:<syntaxhighlight lang="sql">
ALTER TABLE students ADD COLUMN address varchar(50);

</syntaxhighlight>ولتعديل عدد محارفه المتاحة:<syntaxhighlight lang="sql">
ALTER TABLE students ALTER COLUMN address TYPE varchar(100);

</syntaxhighlight>ولإضافة قيد ألا يكون بقيمة <code>NULL</code>:<syntaxhighlight lang="sql">
ALTER TABLE students ALTER COLUMN address SET NOT NULL;

</syntaxhighlight>ولإزالة هذا القيد:<syntaxhighlight lang="sql">
ALTER TABLE students ALTER COLUMN address DROP NOT NULL;

</syntaxhighlight>ولإضافة قيد على مستوى الجدول <code>students</code> بأن يكون هذا العمود مفتاحًا ثانويًا باسم <code>st_fk</code> يرتبط مع الجدول <code>addresses</code> عبر العمود <code>address</code>:<syntaxhighlight lang="sql">
ALTER TABLE students ADD CONSTRAINT st_fk FOREIGN KEY (address) REFERENCES addresses (address);

</syntaxhighlight>ولجعل هذا العمود بقيمة فريدة بقيدٍ باسم <code>add_uniq</code>:<syntaxhighlight lang="sql">
ALTER TABLE students ADD CONSTRAINT add_uniq UNIQUE (address);

</syntaxhighlight>ولحذفه من جديد:<syntaxhighlight lang="sql">
ALTER TABLE students DROP COLUMN address;

</syntaxhighlight>ولجعل العمود <code>studentID</code> مفتاحًا أوليًا للجدول <code>students</code>:<syntaxhighlight lang="sql">
ALTER TABLE students ADD PRIMARY KEY (studentID);

</syntaxhighlight>ولإعادة تسمية الجدول باسم <code>schoolStudents</code>:<syntaxhighlight lang="sql">
ALTER TABLE students RENAME TO schoolStudents;

</syntaxhighlight>

== التوافقية ==
{| class="wikitable"
!SQLServer
!SQLite
!Oracle
!PostgreSQL
!MySQL
|-
|نعم
|نعم
|نعم
|نعم
|نعم
|}

== مصادر ==
* [https://dev.mysql.com/doc/refman/5.7/en/alter-table.html توثيق ALTER TABLE في محرك MySQL]
* [https://www.postgresql.org/docs/current/static/sql-altertable.html توثيق ALTER TABLE في محرك PostgreSQL]
* [https://docs.oracle.com/cd/B28359_01/server.111/b28286/statements_3001.htm توثيق ALTER TABLE في محرك Oracle]
* [https://sqlite.org/lang_altertable.html توثيق ALTER TABLE في محرك SQLite]
* [https://docs.microsoft.com/en-us/sql/t-sql/statements/alter-table-transact-sql توثيق ALTER TABLE في محرك SQLServer]
[[تصنيف:SQL|{{SUBPAGENAME}}]]
[[تصنيف:SQL Administration|{{SUBPAGENAME}}]]
[[تصنيف:SQL Tables|{{SUBPAGENAME}}]]