* (نجمة) عبارة

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

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

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

_metadata العمود غير مضمن في هذه القائمة. يجب الرجوع إليه بشكل صريح.

قبل Databricks Runtime 15.0، يمكن استخدام عبارة star (*) فقط في SELECT القائمة.

بناء الجملة

star_clause
   [ name . ] * [ except_clause ]

except_clause
   EXCEPT ( { column_name | field_name } [, ...] )

المعلمات

  • الاسم

    إذا كان الاسم اسم جدول، فسرد الأعمدة في الجدول المحدد القابل للرجوع إليه. إذا كان الاسم عبارة عن عمود أو اسم حقل من النوع STRUCT'، فسرد الحقول الموجودة في العمود أو الحقل المحدد القابل للرجوع إليه. إذا لم يكن موجودا، فقوائم كافة الأعمدة من كافة الجداول القابلة للرجوع إليها في عبارة FROM.

  • except_clause

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

    يقوم اختياريا باقتطاع الأعمدة أو الحقول من مجموعة الأعمدة القابلة للرجوع إليها المحددة في العبارة select_star .

    • column_name

      عمود يشكل جزءا من مجموعة الأعمدة التي يمكنك الرجوع إليها.

    • field_name

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

    يجب أن يشير كل اسم إلى عمود مضمن في مجموعة الأعمدة التي يمكنك الرجوع إليها أو حقولها. وإلا، فإن Databricks SQL يثير خطأ UNRESOLVED_COLUMN . إذا تداخلت الأسماء أو لم تكن فريدة، فإن Databricks SQL يثير خطأ EXCEPT_OVERLAPPING_COLUMNS .

الأمثلة

– Return all columns in the FROM clause
> SELECT * FROM VALUES(1, 2) AS TA(c1, c2), VALUES(‘a’, b’) AS TB(ca, cb);
  1  2  a  b

– Return all columns from TA
> SELECT TA.* FROM VALUES(1, 2) AS TA(c1, c2), VALUES(‘a’, b’) AS TB(ca, cb);
  1  2

– Return all columns except TA.c1 and TB.cb
> SELECT * EXCEPT (c1, cb)  FROM VALUES(1, 2) AS TA(c1, c2), VALUES(‘a’, b’) AS TB(ca, cb);
  2  a

– Return all columns, but strip the field x from the struct.
> SELECT TA.* EXCEPT (c1.x) FROM VALUES(named_struct(‘x’, x, ‘y’, ‘y’), 2) AS (c1, c2), VALUES(‘a’, b’) AS TB(ca, cb);
  { y } 2 a b

-- Return all fields in c1.
> SELECT c1.* FROM VALUES(named_struct(‘x’, x, ‘y’, ‘y’), 2) AS (c1, c2), VALUES(‘a’, b’) AS TB(ca, cb);
  x  y

– Return the first not-NULL column in TA
> SELECT coalesce(TA.*)  FROM VALUES(1, 2) AS TA(c1, c2), VALUES(‘a’, b’) AS TB(ca, cb);
  1