Administración de roles de tabla externa

A las entidades de seguridad se les concede acceso a los recursos a través de un modelo de control de acceso basado en roles, donde sus roles de seguridad asignados determinan su acceso a los recursos.

En tablas externas, el único rol de seguridad es admins. La tabla admins externa tiene la capacidad de ver, modificar y quitar la tabla externa.

En este artículo, aprenderá a usar comandos de administración para ver los administradores existentes, así como agregar y quitar administradores en tablas externas.

Permisos

Debe tener permisos de administrador de base de datos o ser administrador de tablas externas en la tabla externa específica para ejecutar estos comandos. Para más información, vea Control de acceso basado en roles.

Mostrar administradores existentes

Antes de agregar o quitar entidades de seguridad, puede usar el .show comando para ver una tabla con todas las entidades de seguridad que ya tienen acceso de administrador en la tabla externa.

Sintaxis

Para mostrar todos los roles:

.showexternal table ExternalTableName principals

Para mostrar los roles:

.showexternal table ExternalTableName principal roles

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Type	Obligatorio	Descripción
ExternalTableName	string	✔️	Nombre de la tabla externa para la que se van a enumerar las entidades de seguridad.

Ejemplo

El siguiente comando enumera todas las entidades de seguridad que tienen acceso a la Samples tabla externa.

.show external table Samples principals

Salida del ejemplo

Role	PrincipalType	PrincipalDisplayName	PrincipalObjectId	PrincipalFQN
Administrador de ejemplos de tablas externas	Usuario de Microsoft Entra	Abbi Atkins	cd709aed-a26c-e3953dec735e	aaduser=abbiatkins@fabrikam.com

Agregar y quitar administradores

En esta sección se proporciona sintaxis, parámetros y ejemplos para agregar y quitar entidades de seguridad.

Sintaxis

Action external table ExternalTableName ( admins Principal [, Principal...] ) [skip-results] [ Description ]

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Type	Obligatorio	Descripción
Acción	string	✔️	.addComando , .dropo .set. .add agrega las entidades de seguridad especificadas, .drop quita las entidades de seguridad especificadas y .set agrega las entidades de seguridad especificadas y quita todas las anteriores.
ExternalTableName	string	✔️	Nombre de la tabla externa para la que se van a agregar entidades de seguridad.
Principal	string	✔️	Una o varias entidades de seguridad. Para obtener instrucciones sobre cómo especificar estas entidades de seguridad, consulte Referencia a entidades de seguridad.
skip-results	string		Si se proporciona, el comando no devolverá la lista actualizada de entidades de seguridad de tabla externas.
Descripción	string		Texto para describir el cambio que se mostrará al usar el .show comando .

Nota:

El .set comando con none en lugar de una lista de entidades de seguridad quitará todas las entidades de seguridad.

Ejemplos

En los ejemplos siguientes, verá cómo agregar administradores, quitar administradores y agregar y quitar administradores en el mismo comando.

Adición de administradores con .add

En el ejemplo siguiente se agrega una entidad de seguridad al admins rol de la Samples tabla externa.

.add external table Samples admins ('aaduser=imikeoein@fabrikam.com')

Quitar administradores con .drop

En el ejemplo siguiente se quitan todas las entidades de seguridad del grupo del admins rol de la Samples tabla externa.

.drop external table Samples admins ('aadGroup=SomeGroupEmail@fabrikam.com')

Agregar nuevos administradores y quitar el antiguo con .set

En el ejemplo siguiente se quitan las entidades de seguridad existentes admins y se agregan las entidades de seguridad proporcionadas como admins en la Samples tabla externa.

.set external table Samples admins ('aaduser=imikeoein@fabrikam.com', 'aaduser=abbiatkins@fabrikam.com')

Quitar todos los administradores con .set

El comando siguiente quita todos los existentes admins en la Samples tabla externa.

.set external table Samples admins none

Contenido relacionado

• current_principal_details()