SHOW GROUPS

  • Artículo

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Enumera los grupos que coinciden con un patrón de expresión regular proporcionado de forma opcional. Si no proporciona un patrón, el comando enumera todos los grupos del sistema. De forma opcional, puede proporcionar un identificador para mostrar solo los grupos a los que pertenece un usuario o grupo específico.

Si se proporciona una entidad de seguridad mediante WITH {USER | GROUP}, un valor booleano que no sea NULL en la columna directGroup indica la pertenencia de la entidad de seguridad.

  • TRUE: la entidad de seguridad es un miembro directo del grupo.
  • FALSE: la entidad de seguridad es un miembro indirecto del grupo.

Si no se usa WITH {USER | GROUP}, directGroup siempre será NULL.

Sintaxis

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

Parámetros

  • user_principal

    Muestra solo grupos que contienen el usuario especificado.

  • group_principal

    Muestra solo grupos que contienen el grupo especificado.

  • regex_pattern

    Literal de cadena con un patrón de expresión regular limitado que se usa para filtrar los resultados de la instrucción.

    • * al principio y al final de un patrón coincide con una subcadena.
    • * solo al final de un patrón coincide con el inicio de un grupo.
    • | separa varias expresiones regulares, cualquiera de las cuales puede coincidir.
    • La coincidencia de patrones no diferencia entre mayúsculas y minúsculas.

Ejemplos

-- 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