Compartir a través de

SHOW GROUPS

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.

Para ejecutar este comando, debe ser administrador.

Sintaxis

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

Parámetros

  • usuario_principal

    Muestra solo grupos que contienen el usuario especificado.

  • grupo_principal

    Muestra solo grupos que contienen el grupo especificado.

  • regex_pattern

    Un literal STRING que tiene un patrón de expresión regular limitado, utilizado 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.

DEVOLUCIONES

Una tabla con las columnas siguientes:

  • name STRING NOT NULL

    Nombre del grupo.

  • directGroup BOOLEAN

    • TRUE: la entidad de seguridad es un miembro directo del grupo.
    • FALSE: la entidad de seguridad es un miembro indirecto del grupo.
    • NULL: si no se especificó ningún principal.

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
  • Last updated on