Dieses Dokument enthält eine Referenz zu IAM-Berechtigungen (Identity and Access Management) für Dataplex Universal Catalog-Ressourcen. Mit diesen Berechtigungen können Sie benutzerdefinierte Rollen erstellen oder den detaillierten Zugriff überprüfen, der für die Metadatenverwaltung, Datenscans, Lake-Vorgänge, Aufgaben und Umgebungen erforderlich ist.
Berechtigungen und Rollen
Sie erteilen Nutzern nicht direkt Berechtigungen. Stattdessen weisen Sie ihnen Rollen zu, die eine oder mehrere Berechtigungen umfassen. Dieser Ansatz entspricht dem Prinzip der geringsten Berechtigung, das Sie dazu anregt, einem Nutzer oder Dienstkonto nur den Zugriff zu gewähren, der für die Ausführung seiner Aufgaben erforderlich ist.
IAM bietet vordefinierte Rollen für häufige Anwendungsfälle. Wenn diese vordefinierten Rollen nicht Ihren spezifischen Anforderungen entsprechen, können Sie eigene benutzerdefinierte Rollen erstellen, die nur die erforderlichen Berechtigungen enthalten.
Weitere Informationen zu vordefinierten Dataplex Universal Catalog-Rollen und den darin enthaltenen Berechtigungen finden Sie unter IAM-Rollen für Dataplex Universal Catalog.
Eine ausführliche Beschreibung von IAM und den entsprechenden Funktionen finden Sie in der IAM-Dokumentation.
Berechtigungen zum Festlegen und Abrufen von IAM-Richtlinien
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die zum Abrufen und Festlegen von IAM-Berechtigungen erforderlich sind:
| Ressource | API-Methode | IAM-Berechtigung |
|---|---|---|
| Aspekttypen | GetIamPolicy | dataplex.aspectTypes.getIamPolicy |
| Aspekttypen | SetIamPolicy | dataplex.aspectTypes.setIamPolicy |
| Eintragsgruppen | GetIamPolicy | dataplex.entryGroups.getIamPolicy |
| Eintragsgruppen | SetIamPolicy | dataplex.entryGroups.setIamPolicy |
| Eintragstypen | GetIamPolicy | dataplex.entryTypes.getIamPolicy |
| Eintragstypen | SetIamPolicy | dataplex.entryTypes.setIamPolicy |
| Lakes | GetIamPolicy | dataplex.lakes.getIamPolicy |
| Lakes | SetIamPolicy | dataplex.lakes.setIamPolicy |
Berechtigungen für die Metadatenverwaltung
Die Berechtigungen, die zum Ausführen von Vorgängen für Eintragstypen, Eintragslinktypen, Aspekttypen, Eintragsgruppen, Einträge und Eintragslinks erforderlich sind, hängen davon ab, ob es sich um Systemressourcen oder benutzerdefinierte Ressourcen handelt. Systemressourcen werden von Dataplex Universal Catalog definiert und benutzerdefinierte Ressourcen von Ihnen oder Ihrer Organisation.
Sie können Einträge und Eintragslinks mit zusätzlichen Informationen anreichern, indem Sie Aspekte anhängen.
Für Vorgänge, die sich auf mehrere Ressourcen beziehen (z. B. das Erstellen eines Eintrags eines bestimmten Eintrags oder das Hinzufügen eines Aspekts eines bestimmten Aspekttyps zu einem Eintrag oder Eintragslink), benötigen Sie möglicherweise mehrere Berechtigungen, die den Ressourcen zugeordnet sind.
Eintragstypen
Zum Erstellen und Verwalten von Eintragstypen benötigen Sie mindestens die Standardberechtigungen create, get, list, update und delete.
Wenn Sie einen Eintragstyp erstellen, müssen Sie die Berechtigung haben, jeden Aspekttyp zu verwenden, den Sie für diesen Eintragstyp als erforderlich kennzeichnen möchten.
Wenn Sie einen Eintragstyp verwenden möchten (z. B. zum Erstellen von Einträgen eines Eintragstyps), muss Ihnen die Berechtigung use für den Eintragstyp gewährt werden.
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für den Umgang mit Eintragstypen erforderlich sind:
| Vorgang | IAM-Berechtigung |
|---|---|
| Eintragstypen erstellen |
|
| Eintragstypen löschen |
|
| Eintragstypen abrufen | dataplex.entryTypes.get |
| Listeneintragstypen | dataplex.entryTypes.list |
| Eintragstypen aktualisieren |
|
|
Eintragstypen verwenden (beim Erstellen von Einträgen, Aktualisieren von Feldern auf oberster Ebene und erforderlichen Aspekttypwerten) |
|
Aspekttypen
Zum Erstellen und Verwalten von Aspekttypen benötigen Sie die Standardberechtigungen create, get, list, update und delete.
Wenn Sie einen Aspekttyp verwenden möchten, z. B. um ihn als optionalen Aspekt an einen Eintrag anzuhängen oder den erforderlichen Aspekt für den Eintragslink zu aktualisieren, benötigen Sie die Berechtigung use für den Aspekttyp.
Aspekttypen werden in Systemaspekttypen und benutzerdefinierte Aspekttypen unterteilt. Systemaspekttypen werden von Dataplex Universal Catalog erstellt, benutzerdefinierte Aspekttypen von Ihnen oder Ihrer Organisation. Systemaspekttypen werden weiter in nutzbare und schreibgeschützte unterteilt. Weitere Informationen finden Sie unter Kategorien von Aspekttypen.
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für den Umgang mit benutzerdefinierten und Systemaspekttypen erforderlich sind:
| Vorgang | Erforderliche Berechtigungen für benutzerdefinierte Aspekttypen | Für verwendbare Systemaspekttypen erforderliche Berechtigungen | Für schreibgeschützte Systemaspekttypen erforderliche Berechtigungen |
|---|---|---|---|
| Aspekttypen erstellen | dataplex.aspectTypes.create |
– | – |
| Aspekttypen löschen | dataplex.aspectTypes.delete |
– | – |
| Aspekttypen abrufen | dataplex.aspectTypes.get |
Gewährt an allUsers |
Gewährt an allUsers |
| Aspekttypen auflisten | dataplex.aspectTypes.list |
Nicht zutreffend (–) | – |
| Optionale Werte für den Aspekttyp beim Erstellen oder Aktualisieren von Einträgen festlegen |
|
|
– |
| Erforderliche Werte für den Aspekttyp beim Erstellen oder Aktualisieren von Einträgen festlegen |
|
|
– |
| Aspekttypen aktualisieren | dataplex.aspectTypes.update |
– | – |
| Erforderliche Werte für den Aspekttyp beim Erstellen oder Aktualisieren eines Eintragslinks festlegen | – |
|
– |
Eintragsgruppen
Zum Erstellen und Verwalten von Eintragsgruppen benötigen Sie die Standardberechtigungen create, get, list, update und delete.
Eintragsgruppen werden in Systemeintragsgruppen, die von Dataplex Universal Catalog erstellt werden, und benutzerdefinierte Eintragsgruppen, die von Ihnen oder Ihrer Organisation erstellt werden, unterteilt. Weitere Informationen finden Sie unter Kategorien von Eintragsgruppen.
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für den Umgang mit Eintragssammlungen erforderlich sind:
| Vorgang | Erforderliche Berechtigungen für benutzerdefinierte Eintragsgruppen | Erforderliche Berechtigungen für Systemeintragsgruppen (beginnend mit „@“) |
|---|---|---|
| Eintragsgruppen erstellen | dataplex.entryGroups.create |
– |
| Eintragsgruppen löschen | dataplex.entryGroups.delete |
– |
| Eintragsgruppen abrufen | dataplex.entryGroups.get |
dataplex.entryGroups.get |
| Eintragsgruppen auflisten | dataplex.entryGroups.list |
dataplex.entryGroups.list |
| Eintragsgruppen aktualisieren | dataplex.entryGroups.update |
– |
Einträge
Zum Erstellen und Verwalten von Einträgen benötigen Sie die Standardberechtigungen create, get, list, update und delete.
Wichtige Hinweise:
- Für die Methoden „lookup“ (
LookupEntry), „search“ (SearchEntries) und „modify“ (ModifyEntry) ist die Berechtigung des ursprünglichen Quellsystems für den Eintrag erforderlich. Wenn die Quelle beispielsweise eine BigQuery-Tabelle ist, benötigen Sie die Berechtigungbigquery.tables.get, um Metadaten aufzurufen,bigquery.tables.getData, um Datenaspekte aufzurufen, undbigquery.tables.update, um die Metadaten des Eintrags zu ändern. - Wenn keine Berechtigung zum Aufrufen von Datenaspekten vorhanden ist, sind Einträge weiterhin sichtbar, der Inhalt von Datenaspekten wird jedoch ausgeblendet.
- Wenn Sie einen Eintrag erstellen oder die Felder der obersten Ebene eines Eintrags aktualisieren, benötigen Sie die Berechtigung
usefür den Eintragstyp. - Wenn Sie ein erforderliches Attribut erstellen oder aktualisieren, benötigen Sie die Berechtigung
usefür den Eintragstyp eines Eintrags sowie für den zugrunde liegenden Attributtyp. Das liegt daran, dass die erforderlichen Aspekte durch den Eintragstyp erzwungen werden. - Wenn Sie ein optionales Attribut erstellen, aktualisieren oder löschen, benötigen Sie die Berechtigung
usefür den Attributtyp des Attributs. - Wenn Sie einen Eintrag einfügen oder aktualisieren (
UpdateEntrymitallow_missing = True), benötigen Sie die Berechtigungcreate.
Weitere Informationen zu den Eintragstypen, auf denen Einträge basieren, finden Sie unter Kategorien von Eintragstypen.
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für den Umgang mit Einträgen erforderlich sind:
| Vorgang | Eintrag auf Grundlage eines benutzerdefinierten Eintragstyps | Eintrag basierend auf dem verwendbaren Systemeintragstyp | Eintrag basierend auf schreibgeschütztem Systemeintragstyp |
|---|---|---|---|
| Einträge erstellen |
|
|
– |
| Einträge abrufen |
Datenaspekte können nur angezeigt werden, wenn |
Datenaspekte können nur angezeigt werden, wenn |
Datenaspekte können nur angezeigt werden, wenn |
| Listeneinträge | dataplex.entries.list |
dataplex.entries.list |
dataplex.entries.list |
| Lookup-Einträge |
Erfordert die Berechtigung zum Lesen von Metadaten des Quellsystems. Zum Aufrufen von Datenaspekten ist die Berechtigung zum Lesen von Daten aus dem Quellsystem erforderlich. Bei benutzerdefinierten Einträgen, bei denen Dataplex Universal Catalog als Quellsystem behandelt wird, sind diese Berechtigungen |
Erfordert die Berechtigung zum Lesen von Metadaten des Quellsystems. Zum Aufrufen von Datenaspekten ist die Berechtigung zum Lesen von Daten aus dem Quellsystem erforderlich. Bei benutzerdefinierten Einträgen, bei denen Dataplex Universal Catalog als Quellsystem behandelt wird, sind diese Berechtigungen |
Erfordert die Berechtigung zum Lesen von Metadaten des Quellsystems. Zum Aufrufen von Datenaspekten ist die Berechtigung zum Lesen von Daten aus dem Quellsystem erforderlich. Bei benutzerdefinierten Einträgen, bei denen Dataplex Universal Catalog als Quellsystem behandelt wird, sind diese Berechtigungen |
| Einträge bearbeiten |
|
Erfordert die Berechtigung zum Aktualisieren von Metadaten des ursprünglichen Quellsystems. Bei benutzerdefinierten Einträgen ist dies
|
Erfordert die Berechtigung zum Aktualisieren von Metadaten des ursprünglichen Quellsystems.
|
| Einträge durchsuchen |
Leseberechtigung für das ursprüngliche Quellsystem. Bei benutzerdefinierten Einträgen ist dies |
Leseberechtigung für das ursprüngliche Quellsystem. Bei benutzerdefinierten Einträgen ist dies |
Leseberechtigung für das ursprüngliche Quellsystem. Bei benutzerdefinierten Einträgen ist dies |
| Einträge aktualisieren |
|
|
Felder der obersten Ebene und erforderliche Aspekte können nicht bearbeitet werden. |
Eintragslinks
Zum Erstellen und Verwalten von Einstiegslinks benötigen Sie die Berechtigungen create, get, list und delete für dataplex.entryLinks.
Wichtige Hinweise:
- Zum Erstellen von Eintragslinks (
CreateEntryLink) sind auch Berechtigungen für den Eintragslinktyp und Berechtigungen zum Verknüpfen bestimmter Einträge erforderlich. - Wenn Sie einen Eintragslink mit einem erforderlichen Aspekt erstellen, benötigen Sie die Berechtigungen zur Verwendung des Aspekttyps.
- Wenn Sie einen Eintragslink (
UpdateEntryLinkmitallow_missing = True) einfügen oder aktualisieren, benötigen Sie auch dieselben Berechtigungen, die fürCreateEntryLinkerforderlich sind.
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für den Umgang mit Eintragslinks erforderlich sind:
| Vorgang | IAM-Berechtigung |
|---|---|
| Eintragslinks erstellen |
Erforderliche Berechtigungen basierend auf dem Eintragstyp:
Berechtigung zur Verwendung des Eintragslinktyps:
Berechtigungen für alle erforderlichen Aspekte, die durch den Eintragstyp angegeben werden:
|
| Eintragslinks löschen | dataplex.entryLinks.delete (für die Eintragsgruppe) |
| Eintrag-Links abrufen |
|
| Links zu Suchtabelleneinträgen |
Erfordert die Berechtigung zum Lesen von Metadaten des Quellsystems für den Eintrag, für den Eintragslinks gesucht werden. Für verknüpfte benutzerdefinierte Einträge, bei denen Dataplex Universal Catalog als Quellsystem behandelt wird, ist die Berechtigung Bei verknüpften Systemeinträgen ist die Berechtigung die Leseberechtigung des Quellsystems des verknüpften Eintrags. |
| Eintragslink aktualisieren |
Berechtigung zur Verwendung des Eintragslinktyps:
Berechtigungen für alle erforderlichen Aspekte, die durch den Eintragstyp angegeben werden:
Wenn |
Einschränkungen für Aspekte in Einstiegslinks
Für die Verwendung von Aspekten mit Einstiegslinks gelten die folgenden Einschränkungen.
Berechtigungen für Metadatenjobs
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Arbeit mit Metadaten-Importjobs und Metadaten-Exportjobs erforderlich sind.
| Vorgang | IAM-Berechtigung |
|---|---|
| Auf die exportierten Ergebnisse von Metadaten-Exportjobs zugreifen |
|
| Metadaten-Jobs abbrechen |
|
| Metadaten-Exportjobs erstellen |
|
| Metadaten-Importjobs erstellen |
|
| Metadaten-Jobs abrufen |
|
| Metadaten-Jobs auflisten |
|
Systemaspekttypen, Eintragstypen und Eintragslinktypen
Jeder vom System definierte Aspekttyp, Eintragstyp und Eintragstyp für Links hat eigene IAM-Berechtigungen. Diese Berechtigungen haben ein Format wie dataplex.entryGroups.useASPECT_TYPE, dataplex.entryGroups.useENTRY_TYPE oder dataplex.entryGroups.useENTRY_LINK_TYPE. Die Berechtigung für den Systemaspekttyp overview ist beispielsweise dataplex.entryGroups.useOverviewAspect.
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für systemdefinierte Aspekttypen, Eintragstypen und Eintragslinktypen gelten.
| Ressource | IAM-Berechtigung |
|---|---|
contacts (Systemaspekttyp) |
dataplex.entryGroups.useContactsAspect |
data-profile (Systemaspekttyp) |
dataplex.entryGroups.useDataProfileAspect |
data-quality-scorecard (Systemaspekttyp) |
dataplex.entryGroups.useDataQualityScorecardAspect |
generic (Systemaspekttyp) |
dataplex.entryGroups.useGenericAspect |
overview (Systemaspekttyp) |
dataplex.entryGroups.useOverviewAspect |
schema (Systemaspekttyp) |
dataplex.entryGroups.useSchemaAspect |
schema-join (Systemaspekttyp) |
dataplex.entryGroups.useSchemaJoinAspect |
generic (Systemeintragstyp) |
dataplex.entryGroups.useGenericEntry |
definition (Linktyp für Systemeintrag) |
dataplex.entryGroups.useDefinitionEntryLink |
related (Linktyp für Systemeintrag) |
dataplex.entryGroups.useRelatedEntryLink |
synonym (Linktyp für Systemeintrag) |
dataplex.entryGroups.useSynonymEntryLink |
schema-join (Linktyp für Systemeintrag) |
dataplex.entryGroups.useSchemaJoinEntryLink |
Berechtigungen für Lakes, Zonen und Assets
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für den Umgang mit Lakes, Zonen und Assets erforderlich sind:
| API-Methode | IAM-Berechtigung |
|---|---|
| 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 |
Berechtigungen für Aufgaben
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Bearbeitung von Aufgaben erforderlich sind:
| API-Methode | IAM-Berechtigung |
|---|---|
| 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 |
Umgebungsberechtigungen
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für die Arbeit mit Umgebungen erforderlich sind:
| API-Methode | IAM-Berechtigung |
|---|---|
| CreateContent | dataplex.content.create |
| CreateEnvironment | dataplex.environments.create |
| DeleteContent | dataplex.content.delete |
| DeleteEnvironment | dataplex.environments.delete |
| GetContent | dataplex.content.get |
| GetEnvironment | dataplex.environments.get |
| ListContent | dataplex.content.list |
| ListEnvironments | dataplex.environments.list |
| ListSessions | dataplex.environments.get |
| UpdateContent | dataplex.content.update |
| UpdateEnvironment | dataplex.environments.update |
Berechtigungen für Metadaten
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für den Umgang mit Einheiten und Partitionen erforderlich sind:
| API-Methode | IAM-Berechtigung |
|---|---|
| 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 |
Berechtigungen für Datenscans
In der folgenden Tabelle sind die Berechtigungen aufgeführt, die für den Umgang mit Datenscans erforderlich sind:
| API-Methode | IAM-Berechtigung |
|---|---|
| CreateDataScan | dataplex.datascans.create |
| DeleteDataScan | dataplex.datascans.delete |
| GetDataScan (einfache Ansicht) | dataplex.datascans.get |
| GetDataScan (full view) | dataplex.datascans.getData |
| GetDataScanJob (Basisansicht) | dataplex.datascans.get |
| GetDataScanJob (vollständige Ansicht) | dataplex.datascans.getData |
| ListDataScanJobs | dataplex.datascans.get |
| ListDataScans | dataplex.datascans.list |
| RunDataScan | dataplex.datascans.run |
| UpdateDataScan | dataplex.datascans.update |