أسماء وقت التشغيل ل Databricks

يعرف أنواع مختلفة من الكائنات في وقت تشغيل Databricks.

اسم قاعدة البيانات

تعريف قاعدة بيانات. توفر قاعدة بيانات تجميع الكائنات في النشرة المصورة.

بناء الجملة

database_identifier

المعلمات

أمثلة

> use default;

> create database my_db;

اسم المخطط

مرادف لاسم قاعدة البيانات.

اسم الجدول

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

بناء الجملة

{ [ database_name . ] table_identifier |
  { file_format | `file_format` } . `path_to_table` }
  [temporal_specification]

temporal_specification
{
  @ timestamp_encoding |
  @V version |
  TIMESTAMP AS OF expr |
  VERSION AS OF version
}

المعلمات

  • database_name: اسم قاعدة بيانات مؤهل أو غير مؤهل يحتوي على الجدول.

  • table_identifier: معرف يحدد اسم الجدول أو table_alias.

  • file_format: واحد من csv ، ، ، ، ، avro ، ، ( غير حساس parquetorcbinaryFiletextdelta لحالة الأحرف).

  • path_to_table: موقع الجدول في نظام الملفات. يجب أن يكون لديك ANY_FILE الإذن لاستخدام بناء الجملة هذا.

  • temporal_specification: عند استخدام مراجع جدول دلتا عند النقطة المحددة في الوقت أو الإصدار.

    يمكنك استخدام مواصفات مؤقتة فقط ضمن سياق استعلام أو MERGE USING.

    • @ timestamp_encoding: قيمة BIGINT الحرفية موجبة ترميز طابع زمني في تنسيق.
    • إصدار @V:قيمة حرفية إيجابية ل INT تعرف إصدار جدول دلتا.
  • expr: تعبير بسيط يقيم إلى TIMESTAMP. expr يجب أن يكون تعبير ثابت، ولكن قد يحتوي current_date() على أو current_timestamp() .

  • timestamp_expression يمكن أن يكون أي واحد من:

    • '2018-10-18T22:15:12.013Z'، أي، سلسلة يمكن أن يتم تحويلها إلى طابع زمني
    • cast('2018-10-18 13:36:32 CEST' as timestamp)
    • '2018-10-18'، أي، سلسلة تاريخ
    • current_timestamp() - interval 12 hours
    • date_sub(current_date(), 1)
    • أي تعبير آخر يتم أو يمكن أن يتم تحويل إلى طابع زمني
  • version قيمة طويلة يمكن الحصول عليها من إخراج DESCRIBE HISTORY table_spec .

لا timestamp_expressionversion يمكن ولا يمكن أن تكون الكواية الفرعية.

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

إذا كان الاسم مؤهلا مع قاعدة بيانات، يحاول Databricks وقت التشغيل لحل الجدول في الكتالوج الحالي.

Databricks Runtime يثير خطأ إذا كنت تستخدم temporal_specification لجدول غير بتنسيق بحيرة دلتا.

أمثلة

`Employees`

employees

hr.employees

`hr`.`employees`

delta.`somedir/delta_table`

`csv`.`spreadsheets/data.csv`

عرض الاسم

تعريف طريقة عرض. يمكن تأهيل طريقة العرض باسم قاعدة بيانات أو غير مؤهلة باستخدام معرف بسيط.

بناء الجملة

[ database_name . ] view_identifier

المعلمات

  • database_name: اسم قاعدة بيانات مؤهل أو غير مؤهل يحتوي على طريقة العرض.
  • view_identifier: معرف يحدد اسم طريقة العرض أو معرف طريقة العرض ل CTE.

أمثلة

`items`

items

hr.items

`hr`.`items`

اسم العمود

تعريف عمود داخل جدول أو طريقة عرض. يمكن تأهيل العمود باستخدام جدول أو اسم عرض، أو غير مؤهل باستخدام معرف بسيط.

بناء الجملة

[ { table_name | view_name } . ] column_identifier

المعلمات

  • table_name: اسم جدول مؤهل أو غير مؤهل للجدول الذي يحتوي على العمود.
  • view_name: اسم عرض مؤهل أو غير مؤهل للعرض الذي يحتوي على العمود.
  • column_identifier: معرف يحدد اسم العمود.

يجب أن يكون العمود المعرف موجودا داخل الجدول أو طريقة العرض.

أمثلة

> SELECT c1 FROM VALUES(1) AS T(c1);
 c1
 1

اسم الحقل

يعرف حقل داخل البنية. يمكن تأهيل العمود باستخدام جدول أو اسم عرض، أو غير مؤهل باستخدام معرف بسيط.

بناء الجملة

expr { . field_identifier [. ...] }

المعلمات

  • expr: تعبير عن نوع STRUCT.
  • field_identifier: معرف يحدد اسم الحقل.

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

أمثلة

> SELECT addr.address.name
    FROM VALUES (named_struct('address', named_struct('number', 5, 'name', 'Main St'),
                              'city', 'Springfield')) as t(addr);
  Main St

اسم الدالة

يعرف دالة. يمكن تأهيل الدالة باسم قاعدة بيانات أو غير مؤهلة باستخدام معرف بسيط.

بناء الجملة

[ database_name . ] function_identifier

المعلمات

  • database_name: اسم قاعدة بيانات مؤهل أو غير مؤهل يحتوي على الدالة.
  • function_identifier: معرف يحدد اسم الدالة.

أمثلة

`math`.myplus

myplus

math.`myplus`

الاسم المستعار للجدول

تسميات مرجع جدول أو استعلام أو دالة جدول أو أي شكل آخر من أشكال العلاقة.

بناء الجملة

[ AS ] table_identifier [ ( column_identifier1 [, ...] ) ]

المعلمات

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

إذا لم تقدم معرفات الأعمدة، يتم توريث أسمائهم من العلاقة المسماة.

أمثلة

> SELECT a, b FROM VALUES (1, 2) AS t(a, b);
 a  b
 1  2

> DELETE FROM emp AS e WHERE e.c1 = 5;

الاسم المستعار للعمود

تسميات نتيجة تعبير في SELECT قائمة للرجوع إليها.

إذا كان التعبير دالة مولد قيمة جدول، تسميات الاسم المستعار قائمة الأعمدة المنتجة.

بناء الجملة

[AS] column_identifier
[AS] ( column_identifier [, ...] )

المعلمات

بينما الأسماء المستعارة العمود لا تحتاج إلى أن تكون فريدة ضمن قائمة التحديد، التفرد هو شرط للإشارة إلى اسم مستعار بالاسم.

أمثلة

> SELECT 1 AS a;
 a
 1

> SELECT 1 a, 2 b;
 a b
 1 2

> SELECT 1 AS `a`;
 a
 1

> SELECT posexplode(array(2)) AS (i, a);
 i  a
 0  2

> SELECT a + a FROM (SELECT 1 AS a);
 a
 2