إظهار المجموعات

  • مقالة

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

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

إذا تم توفير أساس باستخدام WITH {USER | GROUP}، فإن القيمة المنطقية غير الفارغة في العمود directGroup تشير إلى عضوية الأساسي.

  • TRUE: الأساسي هو عضو مباشر في المجموعة.
  • FALSE: الأساسي هو عضو غير مباشر في المجموعة.

إذا WITH {USER | GROUP} لم يتم استخدامه، directGroup فسيكون دائما NULL.

بناء الجملة

SHOW GROUPS [ WITH USER user_principal |
              WITH GROUP group_principal ]
            [ [ LIKE ] regex_pattern ]

المعلمات

  • user_principal

    إظهار المجموعات التي تحتوي على المستخدم المحدد فقط.

  • group_principal

    إظهار المجموعات التي تحتوي على المجموعة المحددة فقط.

  • regex_pattern

    سلسلة حرفية مع نمط تعبير عادي محدود يستخدم لتصفية نتائج العبارة.

    • * في بداية ونهاية نمط يتطابق على سلسلة فرعية.
    • * فقط في نهاية النمط يطابق بداية المجموعة.
    • | يفصل بين تعبيرات عادية متعددة، يمكن أن يتطابق أي منها.
    • مطابقة النمط غير حساسة لحالة الأحرف.

الأمثلة

-- Lists all groups.
> SHOW GROUPS;
         name directGroup
 ------------ -----------
     tv_alien        NULL
        alien        NULL
  californian        NULL
  pastafarian        NULL

-- Lists groups with name containing with string pattern `rou`.
> SHOW GROUPS LIKE '*al*';
         name directGroup
 ------------ -----------
     tv_alien        NULL
        alien        NULL
  californian        NULL

-- Lists groups with Alf as a member.
> SHOW GROUPS WITH USER `alf@melmak.et`;
         name directGroup
 ------------ -----------
     tv_alien        true
        alien       false