En este documento, se proporciona una referencia de los permisos de Identity and Access Management (IAM) para los recursos de Knowledge Catalog. Usa estos permisos para crear roles personalizados o verificar el acceso detallado que se requiere para la administración de metadatos, los análisis de datos, las operaciones de lake, las tareas y los entornos.
Permisos y roles
No otorgas permisos a los usuarios de forma directa. En su lugar, les otorgas roles, que incluyen uno o más permisos. Este enfoque se alinea con el principio de privilegio mínimo, lo que te anima a otorgar solo el acceso necesario para que un usuario o una cuenta de servicio realicen sus tareas.
La IAM ofrece roles predefinidos para casos de uso comunes. Si estos roles predefinidos no satisfacen tus necesidades específicas, puedes crear tus propios roles personalizados que contengan solo los permisos específicos necesarios.
Para obtener más información sobre los roles predefinidos de Knowledge Catalog y los permisos que contienen, consulta Roles de IAM de Knowledge Catalog.
Para obtener una descripción detallada de IAM y sus características, consulta la documentación de IAM.
Permisos para configurar y obtener políticas de IAM
En la siguiente tabla, se enumeran los permisos necesarios para obtener y establecer permisos de IAM:
| Recurso | Método de la API | Permisos de IAM |
|---|---|---|
| Tipos de aspecto | GetIamPolicy |
dataplex.aspectTypes.getIamPolicy |
| Tipos de aspecto | SetIamPolicy |
dataplex.aspectTypes.setIamPolicy |
| Grupos de entrada | GetIamPolicy |
dataplex.entryGroups.getIamPolicy |
| Grupos de entrada | SetIamPolicy |
dataplex.entryGroups.setIamPolicy |
| Tipos de entrada | GetIamPolicy |
dataplex.entryTypes.getIamPolicy |
| Tipos de entrada | SetIamPolicy |
dataplex.entryTypes.setIamPolicy |
| Lakes | GetIamPolicy |
dataplex.lakes.getIamPolicy |
| Lakes | SetIamPolicy |
dataplex.lakes.setIamPolicy |
Permisos de administración de metadatos
El conjunto de permisos que se requiere para realizar operaciones en tipos de entrada, tipos de vínculos de entrada, tipos de aspectos, grupos de entradas, entradas y vínculos de entrada depende de si los recursos son del sistema o personalizados. Los recursos del sistema los define Knowledge Catalog, y los recursos personalizados los defines tú o tu organización.
Para enriquecer las entradas y los vínculos de entrada con información adicional, puedes adjuntar aspectos.
Para realizar operaciones relacionadas con varios recursos (por ejemplo, crear una entrada de un tipo de entrada específico o agregar un aspecto de un tipo de aspecto específico a una entrada o un vínculo de entrada), es posible que necesites varios permisos asociados con los recursos.
Tipos de entrada
Para crear y administrar tipos de entradas, se te deben otorgar, al menos, los permisos estándar
create, get, list, update y delete.
Cuando creas un tipo de entrada, se te deben otorgar permisos para usar cada tipo de aspecto que quieras marcar como obligatorio para ese tipo de entrada.
Para usar un tipo de entrada (por ejemplo, para crear entradas de un tipo de entrada), se te debe
otorgar el permiso use en el tipo de entrada.
En la siguiente tabla, se enumeran los permisos necesarios para operar en los tipos de entradas:
| Operación | Permisos de IAM |
|---|---|
Create entry types |
|
Delete entry types |
|
Get entry types |
dataplex.entryTypes.get |
List entry types |
dataplex.entryTypes.list |
Update entry types |
|
|
Usa tipos de entrada (cuando se crean entradas, se actualizan los campos de entrada de nivel superior y los valores de tipo de aspecto obligatorios) |
|
Tipos de aspecto
Para crear y administrar tipos de aspectos, se te deben otorgar los permisos estándar create,
get, list, update y delete.
Para usar un tipo de aspecto (por ejemplo, para adjuntarlo como un aspecto opcional en una
entrada o actualizar el aspecto requerido en el vínculo de entrada), se te debe otorgar el
permiso use en el tipo de aspecto.
Los tipos de aspectos se clasifican en tipos de aspectos del sistema y tipos de aspectos personalizados. Knowledge Catalog crea los tipos de aspectos del sistema, y tú o tu organización crean los tipos de aspectos personalizados. Los tipos de aspectos del sistema se clasifican en utilizables y de solo lectura. Para obtener más información, consulta Categorías de tipos de aspectos.
En la siguiente tabla, se enumeran los permisos necesarios para operar en los tipos de aspectos personalizados y del sistema:
| Operación | Permisos necesarios para los tipos de aspectos personalizados | Permisos necesarios para los tipos de aspectos del sistema que se pueden usar | Permisos necesarios para los tipos de aspectos del sistema de solo lectura |
|---|---|---|---|
Create aspect types |
dataplex.aspectTypes.create |
No aplicable | No aplicable |
Delete aspect types |
dataplex.aspectTypes.delete |
No aplicable | No aplicable |
Get aspect types |
dataplex.aspectTypes.get |
Se otorgó a allUsers |
Se otorgó a allUsers |
List aspect types |
dataplex.aspectTypes.list |
No aplicable | No aplicable |
| Cuando crees o actualices entradas, establece valores de tipo de aspecto opcionales |
|
|
No aplicable |
| Cuando crees o actualices entradas, establece los valores de tipo de aspecto requeridos |
|
|
No aplicable |
Update aspect types |
dataplex.aspectTypes.update |
N/A | N/A |
| Establece los valores de tipo de aspecto requeridos cuando crees o actualices el vínculo de entrada | N/A |
|
N/A |
Grupos de entrada
Para crear y administrar grupos de entradas, se te deben otorgar los permisos estándar create,
get, list, update y delete.
Los grupos de entradas se clasifican en grupos de entradas del sistema, que crea Knowledge Catalog, y grupos de entradas personalizados, que creas tú o tu organización. Para obtener más información, consulta Categorías de grupos de entradas.
En la siguiente tabla, se enumeran los permisos necesarios para operar en grupos de entradas:
| Operación | Permisos necesarios para los grupos de entradas personalizados | Permisos necesarios para los grupos de entrada del sistema (que comienzan con @) |
|---|---|---|
Create entry groups |
dataplex.entryGroups.create |
No aplicable |
Delete entry groups |
dataplex.entryGroups.delete |
No aplicable |
Get entry groups |
dataplex.entryGroups.get |
dataplex.entryGroups.get |
List entry groups |
dataplex.entryGroups.list |
dataplex.entryGroups.list |
Update entry groups |
dataplex.entryGroups.update |
No aplicable |
Entradas
Para crear y administrar entradas, se te deben otorgar los permisos estándar create, get,
list, update y delete.
Ten en cuenta lo siguiente:
- Para los métodos de búsqueda (
<code>LookupEntry</code>) y búsqueda (<code>SearchEntries</code>), se requiere el permiso del sistema de origen original en la entrada. Por ejemplo, si la fuente es una tabla de BigQuery, necesitas el permisobigquery.tables.getpara ver los metadatos ybigquery.tables.getDatapara ver los aspectos de los datos. - Si no tienes permiso para ver los aspectos de los datos, las entradas seguirán siendo visibles, pero el contenido de los aspectos de los datos estará oculto.
- Cuando creas una entrada o actualizas los campos de nivel superior de una entrada, se te debe otorgar el permiso
useen el tipo de entrada. - Cuando creas o actualizas un aspecto obligatorio, se te debe otorgar el permiso
useen el tipo de entrada de una entrada, así como en el tipo de aspecto subyacente. Esto se debe a que el tipo de entrada aplica los aspectos obligatorios. - Cuando creas, actualizas o borras un aspecto opcional, se te debe otorgar
el permiso
useen el tipo de aspecto de un aspecto. - Cuando actualizas o insertas una entrada (
<code>UpdateEntry</code>con<code>allow_missing = True</code>), se te debe otorgar el permisocreate.
Para obtener más información sobre los tipos de entradas en los que se basan las entradas, consulta Categorías de tipos de entradas.
En la siguiente tabla, se enumeran los permisos necesarios para operar con entradas:
| Operación | Entrada basada en un tipo de entrada personalizado | Entrada basada en el tipo de entrada del sistema que se puede usar | Entrada basada en el tipo de entrada del sistema de solo lectura |
|---|---|---|---|
Create entries |
|
|
No aplicable |
Get entries |
Para ver los aspectos de los datos,
también se requiere |
Para ver los aspectos de los datos,
también se requiere |
Para ver los aspectos de los datos,
también se requiere |
List entries |
dataplex.entries.list |
dataplex.entries.list |
dataplex.entries.list |
Lookup entries |
Requiere permiso de lectura de metadatos del sistema de origen. Se requiere permiso para leer datos del sistema de origen para ver los aspectos de los datos. En el caso de las entradas personalizadas, en las que Knowledge Catalog se trata como el sistema de origen, estos permisos son |
Requiere permiso de lectura de metadatos del sistema de origen. Se requiere permiso para leer datos del sistema de origen para ver los aspectos de los datos. En el caso de las entradas personalizadas, en las que Knowledge Catalog se trata como el sistema de origen, estos permisos son |
Requiere permiso de lectura de metadatos del sistema de origen. Se requiere permiso para leer datos del sistema de origen para ver los aspectos de los datos. En el caso de las entradas personalizadas, en las que Knowledge Catalog se trata como el sistema de origen, estos permisos son |
Search entries |
Permiso de lectura del sistema de origen original. En el caso de las entradas personalizadas, es |
Permiso de lectura del sistema de origen original. En el caso de las entradas personalizadas, es |
Permiso de lectura del sistema de origen original. En el caso de las entradas personalizadas, es |
Update entries |
|
|
Los campos de nivel superior y los aspectos obligatorios no se pueden editar. |
Vínculos de entrada
Para crear y administrar vínculos de entrada, se te deben otorgar los permisos create, get, list
y delete en dataplex.entryLinks.
Ten en cuenta lo siguiente:
- La creación de vínculos de entrada (
CreateEntryLink) también requiere permisos en el tipo de vínculo de entrada y permisos para las entradas específicas del vínculo. - Cuando creas un vínculo de entrada con un aspecto obligatorio, necesitas los permisos para usar el tipo de aspecto.
- Cuando actualizas o insertas un vínculo de entrada (
UpdateEntryLinkconallow_missing = True), también debes tener los mismos permisos necesarios paraCreateEntryLink.
En la siguiente tabla, se enumeran los permisos necesarios para operar con vínculos de entrada:
| Operación | Permisos de IAM |
|---|---|
| Crea vínculos de entrada |
Permisos necesarios según el tipo de vínculo de entrada:
Permiso para usar el tipo de vínculo de entrada:
Permisos para cualquier aspecto obligatorio que especifique el tipo de vínculo de entrada:
|
| Borra vínculos de entrada | dataplex.entryLinks.delete (en el grupo de entradas) |
| Obtén vínculos de entrada |
|
| Vínculos de entrada de búsqueda |
Requiere el permiso de lectura de metadatos del sistema de origen en la entrada para la que se buscan los vínculos de entrada. Para las entradas personalizadas vinculadas, en las que Knowledge Catalog se trata como el sistema de origen, los permisos son En el caso de las entradas de sistema vinculadas, el permiso es el permiso de lectura del sistema de origen de la entrada vinculada. |
| Actualiza el vínculo de entrada |
Permiso para usar el tipo de vínculo de entrada:
Permisos para cualquier aspecto obligatorio que especifique el tipo de vínculo de entrada:
Si |
Limitaciones de los aspectos en los vínculos de entrada
Las siguientes limitaciones se aplican al uso de aspectos con vínculos de entrada.
Conjuntos de contextos
Los conjuntos de contexto son contenedores limitados de recursos de datos de destino y metadatos que se usan para fundamentar los modelos de IA en tu lógica empresarial de propiedad. Si bien pueden contener información específica de la base de datos, como plantillas de consulta en SQL o consultas de búsqueda de valores para herramientas de texto a SQL como QueryData, Knowledge Studio también usa conjuntos de contexto para alojar glosarios de terminología, descripciones generales de tablas estructuradas y asignaciones de datos empresariales.
Para obtener más información sobre cómo se usan los conjuntos de contexto en Google Cloud, consulta la descripción general de los conjuntos de contexto para Knowledge Studio, AlloyDB para PostgreSQL, Cloud SQL para MySQL, Cloud SQL para PostgreSQL o Spanner.
Para crear y administrar conjuntos de contexto para la fundamentación de IA, se te deben otorgar los siguientes roles de IAM:
- Visualizador del catálogo de Dataplex (
roles/dataplex.catalogViewer): Acceso de solo lectura para ver, enumerar y descargar conjuntos de contexto, y para ver ubicaciones. - Editor del catálogo de Dataplex (
roles/dataplex.catalogEditor): Acceso para actualizar, borrar, subir y descargar conjuntos de contexto. - Administrador del catálogo de Dataplex (
roles/dataplex.catalogAdmin) o Propietario del grupo de entradas de Dataplex (roles/dataplex.entryGroupOwner): Acceso de administrador completo a los conjuntos de contexto, incluido el permisodataplex.entryGroups.setIamPolicynecesario para crear conjuntos de contexto.
En la siguiente tabla, se enumeran los permisos de IAM necesarios para operar en conjuntos de contexto:
| Operación | Permisos de IAM |
|---|---|
| Crea conjuntos de contextos | dataplex.entryGroups.createContextSet |
| Borrar conjuntos de contextos | dataplex.entryGroups.deleteContextSet |
| Leer conjuntos de información contextual | dataplex.entryGroups.getContextSet |
| Actualizar conjuntos de información contextual | dataplex.entryGroups.updateContextSet |
| Cambios en el contexto de la solicitud | dataplex.entryGroups.requestContextChanges |
| Crea entradas de contexto | dataplex.entries.createContext |
| Borra entradas de contexto | dataplex.entries.deleteContext |
| Puede leer entradas de contexto. | dataplex.entries.getContext |
| Enumera las entradas de contexto | dataplex.entries.listContext |
| Actualiza las entradas de contexto | dataplex.entries.updateContext |
Para obtener más información, consulta Roles de IAM de Knowledge Catalog.
Permisos de trabajos de metadatos
En la siguiente tabla, se enumeran los permisos necesarios para trabajar con trabajos de importación de metadatos y trabajos de exportación de metadatos.
| Operación | Permisos de IAM |
|---|---|
| Accede a los resultados exportados de los trabajos de exportación de metadatos |
|
Cancel metadata jobs |
|
Create metadata export jobs |
|
Create metadata import jobs |
|
Get metadata jobs |
|
List metadata jobs |
|
Tipos de aspectos, tipos de entradas y tipos de vínculos de entradas del sistema
Cada tipo de aspecto, tipo de entrada y tipo de vínculo de entrada definidos por el sistema tiene sus propios permisos de IAM. Estos permisos
usan un formato como dataplex.entryGroups.useASPECT_TYPE,
dataplex.entryGroups.useENTRY_TYPE o
dataplex.entryGroups.useENTRY_LINK_TYPE. Por ejemplo,
el permiso para el tipo de aspecto del sistema overview es
dataplex.entryGroups.useOverviewAspect.
En la siguiente tabla, se enumeran los permisos que se aplican a los tipos de aspectos, de entradas y de vínculos de entradas definidos por el sistema.
| Recurso | Permisos de IAM |
|---|---|
contacts (tipo de aspecto del sistema) |
dataplex.entryGroups.useContactsAspect |
data-profile (tipo de aspecto del sistema) |
dataplex.entryGroups.useDataProfileAspect |
data-quality-rule-template (tipo de aspecto del sistema) |
dataplex.entryGroups.useDataQualityRuleTemplateAspect |
data-quality-scorecard (tipo de aspecto del sistema) |
dataplex.entryGroups.useDataQualityScorecardAspect |
data-rules (tipo de aspecto del sistema) |
dataplex.entryGroups.useDataRulesAspect |
generic (tipo de aspecto del sistema) |
dataplex.entryGroups.useGenericAspect |
guidelines (tipo de aspecto del sistema) |
dataplex.entryGroups.useGuidelinesAspect |
overview (tipo de aspecto del sistema) |
dataplex.entryGroups.useOverviewAspect |
schema (tipo de aspecto del sistema) |
dataplex.entryGroups.useSchemaAspect |
schema-join (tipo de aspecto del sistema) |
dataplex.entryGroups.useSchemaJoinAspect |
generic (tipo de entrada del sistema) |
dataplex.entryGroups.useGenericEntry |
definition (tipo de vínculo de entrada del sistema) |
dataplex.entryGroups.useDefinitionEntryLink |
related (tipo de vínculo de entrada del sistema) |
dataplex.entryGroups.useRelatedEntryLink |
synonym (tipo de vínculo de entrada del sistema) |
dataplex.entryGroups.useSynonymEntryLink |
schema-join (tipo de vínculo de entrada del sistema) |
dataplex.entryGroups.useSchemaJoinEntryLink |
Permisos de lake, zona y recurso
En la siguiente tabla, se enumeran los permisos necesarios para operar en lakes, zonas y recursos:
| Método de la API | Permisos de IAM |
|---|---|
CreateAsset |
dataplex.assets.create |
CreateLake |
dataplex.lakes.create |
CreateZone |
dataplex.zones.create |
DeleteAsset |
dataplex.assets.delete |
DeleteLake |
dataplex.lakes.delete |
DeleteZone |
dataplex.zones.delete |
GetAsset |
dataplex.assets.get |
GetLake |
dataplex.lakes.get |
GetZone |
dataplex.zones.get |
ListAssetActions |
dataplex.assetActions.list |
ListAssets |
dataplex.assets.list |
ListLakeActions |
dataplex.lakeActions.list |
ListLakes |
dataplex.lakes.list |
ListZoneActions |
dataplex.zoneActions.list |
ListZones |
dataplex.zones.list |
UpdateAsset |
dataplex.assets.update |
UpdateLake |
dataplex.lakes.update |
UpdateZone |
dataplex.zones.update |
Permisos de tareas
En la siguiente tabla, se enumeran los permisos necesarios para operar en las tareas:
| Método de la API | Permisos de IAM |
|---|---|
CancelJob |
dataplex.tasks.cancel |
CreateTask |
dataplex.tasks.create |
DeleteTask |
dataplex.tasks.delete |
GetJob |
dataplex.tasks.get |
GetTask |
dataplex.tasks.get |
ListJobs |
dataplex.tasks.get |
ListTasks |
dataplex.tasks.list |
UpdateTask |
dataplex.tasks.update |
Permisos de metadatos
En la siguiente tabla, se enumeran los permisos necesarios para operar en entidades y particiones:
| Método de la API | Permisos de IAM |
|---|---|
CreateEntity |
dataplex.entities.create |
CreatePartition |
dataplex.partitions.create |
DeleteEntity |
dataplex.entities.delete |
DeletePartition |
dataplex.partitions.delete |
GetEntity |
dataplex.entities.get |
GetPartition |
dataplex.partitions.get |
ListEntities |
dataplex.entities.list |
ListPartitions |
dataplex.partitions.list |
Permisos de análisis de datos
En la siguiente tabla, se enumeran los permisos necesarios para operar en los análisis de datos:
| Método de la API | Permisos de IAM |
|---|---|
CancelDataScanJob |
dataplex.datascans.cancel |
CreateDataScan |
dataplex.datascans.create |
DeleteDataScan |
dataplex.datascans.delete |
GetDataScan (vista básica) |
dataplex.datascans.get |
GetDataScan (vista completa) |
dataplex.datascans.getData |
GetDataScanJob (vista básica) |
dataplex.datascans.get |
GetDataScanJob (vista completa) |
dataplex.datascans.getData |
ListDataScanJobs |
dataplex.datascans.get |
ListDataScans |
dataplex.datascans.list |
RunDataScan |
dataplex.datascans.run |
UpdateDataScan |
dataplex.datascans.update |
Tareas de enriquecimiento de Knowledge Studio
Se requieren los siguientes permisos para crear y administrar tareas de enriquecimiento de Knowledge Studio:
| Operación | Permisos de IAM |
|---|---|
| Crea tareas de enriquecimiento | dataplex.agentTasks.create |
| Borra tareas de enriquecimiento | dataplex.agentTasks.delete |
| Lee los detalles de la tarea de enriquecimiento | dataplex.agentTasks.get |
| Lee y recupera los resultados de los datos subyacentes | dataplex.agentTasks.getData |
| Enumera las tareas de enriquecimiento | dataplex.agentTasks.list |
| Actualizar tareas de enriquecimiento | dataplex.agentTasks.update |
| Ejecuta tareas de enriquecimiento | dataplex.agentTasks.run |
| Solicitar cambios en los grupos de entradas (propuestas) | dataplex.entryGroups.requestChanges |
| Cómo aprobar solicitudes de cambio de metadatos | dataplex.changeRequests.use |
| Cancela las ejecuciones de tareas de enriquecimiento | dataplex.agentTasks.cancel |
Permisos de proveedores de autenticación de terceros
Cuando configures conectores externos, se requieren los siguientes permisos de identidad del agente para administrar los proveedores de autenticación:
| Operación | Permisos de IAM |
|---|---|
| Crea proveedores de autenticación | agentidentity.authProviders.create |
| Visualiza los detalles del proveedor de autenticación | agentidentity.authProviders.get |
| Borra proveedores de autenticación | agentidentity.authProviders.delete |
| Actualiza los proveedores de autenticación | agentidentity.authProviders.update |
Permisos de generación de perfiles de BigQuery
Para permitir que el agente de enriquecimiento realice la generación de perfiles de datos de BigQuery
y lea el historial de consultas de la tabla, debes otorgar los roles de visualizador de datos de BigQuery
(roles/bigquery.dataViewer) y visualizador de recursos de BigQuery
(roles/bigquery.resourceViewer) al agente de servicio de Knowledge Catalog
(service-<var>PROJECT_NUMBER</var>@gcp-sa-dataplex.iam.gserviceaccount.com) del proyecto de destino.