Weitere AWS SDK-Beispiele sind im [AWS Doc SDK Examples ](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub Repo verfügbar.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Beispiele für Lake Formation mit AWS CLI
Die folgenden Codebeispiele zeigen, wie Sie mithilfe von Lake Formation Aktionen ausführen und gängige Szenarien implementieren. AWS Command Line Interface
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `Fügen Sie LF-Tags zur Ressource hinzu`
Das folgende Codebeispiel zeigt die Verwendung. `add-lf-tags-to-resource`
**AWS CLI**
**Um eine oder mehrere Ressourcen LF-tags an eine vorhandene Ressource anzuhängen **
Im folgenden `add-lf-tags-to-resource` Beispiel wird ein Objekt LF-tag an die Tabellenressource angehängt.
```
aws lakeformation add-lf-tags-to-resource \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"analyst"
]
}]
}
```
Ausgabe:
```
{
"Failures": []
}
```
Weitere Informationen finden Sie unter [ Zuweisen LF-Tags zu Datenkatalogressourcen ](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-assigning-tags.html) im *AWS Lake Formation Developer Guide. *
+ API-Details finden Sie [ AddLfTagsToResource ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/add-lf-tags-to-resource.html) in der *AWS CLI Befehlsreferenz. *
### `Batch-Grant-Berechtigungen`
Das folgende Codebeispiel zeigt die Verwendung. `batch-grant-permissions`
**AWS CLI**
**So erteilen Sie den Prinzipalen Berechtigungen für Ressourcen in Massen**
Im folgenden Beispiel für `batch-grant-permissions` wird den Prinzipalen Massenzugriff auf bestimmte Ressourcen gewährt.
```
aws lakeformation batch-grant-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Entries": [{
"Id": "1",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"Permissions": [
"ALL"
],
"PermissionsWithGrantOption": [
"ALL"
]
},
{
"Id": "2",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_customer"
}
},
"Permissions": [
"ALL"
],
"PermissionsWithGrantOption": [
"ALL"
]
},
{
"Id": "3",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-business-analyst"
},
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"Permissions": [
"ALL"
],
"PermissionsWithGrantOption": [
"ALL"
]
},
{
"Id": "4",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"DataCellsFilter": {
"TableCatalogId": "123456789111",
"DatabaseName": "tpc",
"TableName": "dl_tpc_item",
"Name": "developer_item"
}
},
"Permissions": [
"SELECT"
],
"PermissionsWithGrantOption": []
}
]
}
```
Ausgabe:
```
{
"Failures": []
}
```
Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ BatchGrantPermissions ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/batch-grant-permissions.html) in der *AWS CLI Befehlsreferenz*.
### `Batch-Revoke-Berechtigungen`
Das folgende Codebeispiel zeigt die Verwendung. `batch-revoke-permissions`
**AWS CLI**
**So entziehen Sie den Prinzipalen Berechtigungen für Ressourcen in Massen**
Im folgenden Beispiel für `batch-revoke-permissions` wird den Prinzipalen Massenzugriff auf bestimmte Ressourcen gewährt.
```
aws lakeformation batch-revoke-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Entries": [{
"Id": "1",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"Permissions": [
"ALL"
],
"PermissionsWithGrantOption": [
"ALL"
]
},
{
"Id": "2",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-business-analyst"
},
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"Permissions": [
"ALL"
],
"PermissionsWithGrantOption": [
"ALL"
]
}
]
}
```
Ausgabe:
```
{
"Failures": []
}
```
Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ BatchRevokePermissions ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/batch-revoke-permissions.html) in der *AWS CLI Befehlsreferenz*.
### `Transaktion abbrechen`
Das folgende Codebeispiel zeigt die Verwendung. `cancel-transaction`
**AWS CLI**
**So brechen Sie eine Transaktion ab**
Im folgenden Beispiel für `cancel-transaction` wird die Transaktion abgebrochen.
```
aws lakeformation cancel-transaction \
--transaction-id='b014d972ca8347b89825e33c5774aec4'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ CancelTransaction ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/cancel-transaction.html) in der *AWS CLI Befehlsreferenz*.
### `Transaktion bestätigen`
Das folgende Codebeispiel zeigt die Verwendung. `commit-transaction`
**AWS CLI**
**So schreiben Sie eine Transaktion fest**
Im folgenden Beispiel für `commit-transaction` wird die Transaktion festgeschrieben.
```
aws lakeformation commit-transaction \
--transaction-id='b014d972ca8347b89825e33c5774aec4'
```
Ausgabe:
```
{
"TransactionStatus": "committed"
}
```
Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ CommitTransaction ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/commit-transaction.html) in der *AWS CLI Befehlsreferenz*.
### `Datenzellen-Filter erstellen`
Das folgende Codebeispiel zeigt die Verwendung. `create-data-cells-filter`
**AWS CLI**
**Beispiel 1: So erstellen Sie einen Datenzellenfilter**
Im folgenden Beispiel für `create-data-cells-filter` wird ein Datenzellenfilter erstellt, der es ermöglicht, Zugriff auf bestimmte Spalten basierend auf der Zeilenbedingung zu gewähren.
```
aws lakeformation create-data-cells-filter \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"TableData": {
"ColumnNames": ["p_channel_details", "p_start_date_sk", "p_promo_name"],
"DatabaseName": "tpc",
"Name": "developer_promotion",
"RowFilter": {
"FilterExpression": "p_promo_name='ese'"
},
"TableCatalogId": "123456789111",
"TableName": "dl_tpc_promotion"
}
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Datenfilterung und Sicherheit auf Zellebene in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) im *Entwicklerhandbuch für AWS Lake Formation*.
**Beispiel 2: So erstellen Sie einen Spaltenfilter**
Im folgenden Beispiel für `create-data-cells-filter` wird ein Datenzellenfilter erstellt, der es ermöglicht, Zugriff auf bestimmte Spalten zu gewähren.
```
aws lakeformation create-data-cells-filter \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"TableData": {
"ColumnNames": ["p_channel_details", "p_start_date_sk", "p_promo_name"],
"DatabaseName": "tpc",
"Name": "developer_promotion_allrows",
"RowFilter": {
"AllRowsWildcard": {}
},
"TableCatalogId": "123456789111",
"TableName": "dl_tpc_promotion"
}
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Datenfilterung und Sicherheit auf Zellebene in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) im *Entwicklerhandbuch für AWS Lake Formation*.
**Beispiel 3: So erstellen Sie einen Datenfilter mit Ausschlussspalten**
Im folgenden Beispiel für `create-data-cells-filter` wird ein Datenzellenfilter erstellt, der es ermöglicht, Zugriff auf alle Spalten außer den genannten zu gewähren.
```
aws lakeformation create-data-cells-filter \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"TableData": {
"ColumnWildcard": {
"ExcludedColumnNames": ["p_channel_details", "p_start_date_sk"]
},
"DatabaseName": "tpc",
"Name": "developer_promotion_excludecolumn",
"RowFilter": {
"AllRowsWildcard": {}
},
"TableCatalogId": "123456789111",
"TableName": "dl_tpc_promotion"
}
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Datenfilterung und Sicherheit auf Zellebene in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ CreateDataCellsFilter ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/create-data-cells-filter.html) in der *AWS CLI Befehlsreferenz*.
### `erstellen-lf-tag`
Das folgende Codebeispiel zeigt die Verwendung. `create-lf-tag`
**AWS CLI**
**Um zu erstellen LF-Tag **
Das folgende `create-lf-tag` Beispiel erstellt eine LF-Tag mit dem angegebenen Namen und den angegebenen Werten.
```
aws lakeformation create-lf-tag \
--catalog-id '{{123456789111}}' \
--tag-key '{{usergroup}}' \
--tag-values '{{["developer","analyst","campaign"]}}'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [ Managing LF-Tags for metadata access control ](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) im *AWS Lake Formation Developer Guide*.
+ Einzelheiten zur API finden Sie [ CreateLfTag ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/create-lf-tag.html) in der *AWS CLI Befehlsreferenz*.
### `Löschen Sie den Datenzellen-Filter`
Das folgende Codebeispiel zeigt die Verwendung. `delete-data-cells-filter`
**AWS CLI**
**So löschen Sie den Datenzellenfilter**
Im folgenden Beispiel für `delete-data-cells-filter` wird ein bestimmter Datenzellenfilter gelöscht.
```
aws lakeformation delete-data-cells-filter \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"TableCatalogId": "123456789111",
"DatabaseName": "tpc",
"TableName": "dl_tpc_promotion",
"Name": "developer_promotion"
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Datenfilterung und Sicherheit auf Zellebene in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ DeleteDataCellsFilter ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-data-cells-filter.html) in der *AWS CLI Befehlsreferenz*.
### `löschen-LF-Tag`
Das folgende Codebeispiel zeigt die Verwendung. `delete-lf-tag`
**AWS CLI**
**Um eine LF-Tag Definition zu löschen **
Im folgenden `delete-lf-tag` Beispiel wird die LF-Tag Definition gelöscht.
```
aws lakeformation delete-lf-tag \
--catalog-id '{{123456789111}}' \
--tag-key '{{usergroup}}'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [ Managing LF-Tags for metadata access control ](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) im *AWS Lake Formation Developer Guide*.
+ Einzelheiten zur API finden Sie [ DeleteLfTag ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-lf-tag.html) in der *AWS CLI Befehlsreferenz*.
### `Objekte beim Abbrechen löschen`
Das folgende Codebeispiel zeigt die Verwendung. `delete-objects-on-cancel`
**AWS CLI**
**So löschen Sie ein Objekt, wenn die Transaktion abgebrochen wird**
Im folgenden Beispiel für `delete-objects-on-cancel` wird das aufgelistete s3-Objekt gelöscht, wenn die Transaktion abgebrochen wird.
```
aws lakeformation delete-objects-on-cancel \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "012345678901",
"DatabaseName": "tpc",
"TableName": "dl_tpc_household_demographics_gov",
"TransactionId": "1234d972ca8347b89825e33c5774aec4",
"Objects": [{
"Uri": "s3://lf-data-lake-012345678901/target/dl_tpc_household_demographics_gov/run-unnamed-1-part-block-0-r-00000-snappy-ff26b17504414fe88b302cd795eabd00.parquet",
"ETag": "1234ab1fc50a316b149b4e1f21a73800"
}]
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ DeleteObjectsOnCancel ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-objects-on-cancel.html) in der *AWS CLI Befehlsreferenz*.
### `deregistrieren Sie die Ressource`
Das folgende Codebeispiel zeigt die Verwendung. `deregister-resource`
**AWS CLI**
**So heben Sie die Registrierung des Data Lake-Speichers auf**
Im folgenden Beispiel für `deregister-resource` wird die Registrierung der Ressource entsprechend der Verwaltung durch Lake Formation aufgehoben.
```
aws lakeformation deregister-resource \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123"
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Hinzufügen eines Amazon-S3-Standorts zu Ihrem Data Lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ DeregisterResource ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/deregister-resource.html) in der *AWS CLI Befehlsreferenz*.
### `beschreiben-Transaktion`
Das folgende Codebeispiel zeigt die Verwendung. `describe-transaction`
**AWS CLI**
**So rufen Sie Transaktionsdetails ab**
Im folgenden Beispiel für `describe-transaction` werden die Details einer einzelnen Transaktion zurückgegeben.
```
aws lakeformation describe-transaction \
--transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce'
```
Ausgabe:
```
{
"TransactionDescription": {
"TransactionId": "12345972ca8347b89825e33c5774aec4",
"TransactionStatus": "committed",
"TransactionStartTime": "2022-08-10T14:29:04.046000+00:00",
"TransactionEndTime": "2022-08-10T14:29:09.681000+00:00"
}
}
```
Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ DescribeTransaction ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/describe-transaction.html) in der *AWS CLI Befehlsreferenz*.
### `Transaktion erweitern`
Das folgende Codebeispiel zeigt die Verwendung. `extend-transaction`
**AWS CLI**
**So erweitern Sie eine Transaktion**
Im folgenden Beispiel für `extend-transaction` wird die Transaktion erweitert.
```
aws lakeformation extend-transaction \
--transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ ExtendTransaction ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/extend-transaction.html) in der *AWS CLI Befehlsreferenz*.
### `get-data-lake-settings`
Das folgende Codebeispiel zeigt die Verwendung. `get-data-lake-settings`
**AWS CLI**
**So rufen Sie AWS Lake Formation-managed Data Lake-Einstellungen ab **
Im folgenden Beispiel für `get-data-lake-settings` wird die Liste der Data-Lake-Administratoren und anderer Data-Lake-Einstellungen abgerufen.
```
aws lakeformation get-data-lake-settings \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111"
}
```
Ausgabe:
```
{
"DataLakeSettings": {
"DataLakeAdmins": [{
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
}],
"CreateDatabaseDefaultPermissions": [],
"CreateTableDefaultPermissions": [
{
"Principal": {
"DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS"
},
"Permissions": [
"ALL"
]
}
],
"TrustedResourceOwners": [],
"AllowExternalDataFiltering": true,
"ExternalDataFilteringAllowList": [{
"DataLakePrincipalIdentifier": "123456789111"
}],
"AuthorizedSessionTagValueList": [
"Amazon EMR"
]
}
}
```
Weitere Informationen finden Sie unter [Ändern der Standardsicherheitseinstellungen für Ihren Data Lake](https://docs.aws.amazon.com/lake-formation/latest/dg/change-settings.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ GetDataLakeSettings ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-data-lake-settings.html) in der *AWS CLI Befehlsreferenz*.
### `get-effective-permissions-for-path`
Das folgende Codebeispiel zeigt die Verwendung. `get-effective-permissions-for-path`
**AWS CLI**
**So rufen Sie Berechtigungen für Ressourcen ab, die sich unter einem bestimmten Pfad befinden**
Im folgenden Beispiel für `get-effective-permissions-for-path` werden die Lake-Formation-Berechtigungen für eine angegebene Tabelle oder Datenbankressource zurückgegeben, die sich unter einem Pfad in Amazon S3 befindet.
```
aws lakeformation get-effective-permissions-for-path \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111"
}
```
Ausgabe:
```
{
"Permissions": [{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-campaign-manager"
},
"Resource": {
"Database": {
"Name": "tpc"
}
},
"Permissions": [
"DESCRIBE"
],
"PermissionsWithGrantOption": []
},
{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/EMR-RuntimeRole"
},
"Resource": {
"Database": {
"Name": "tpc"
}
},
"Permissions": [
"ALL"
],
"PermissionsWithGrantOption": []
},
{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:saml-provider/oktaSAMLProvider:user/emr-developer"
},
"Resource": {
"Database": {
"Name": "tpc"
}
},
"Permissions": [
"ALL",
"DESCRIBE"
],
"PermissionsWithGrantOption": []
},
{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
},
"Resource": {
"Database": {
"Name": "tpc"
}
},
"Permissions": [
"ALL",
"ALTER",
"CREATE_TABLE",
"DESCRIBE",
"DROP"
],
"PermissionsWithGrantOption": [
"ALL",
"ALTER",
"CREATE_TABLE",
"DESCRIBE",
"DROP"
]
},
{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/LF-GlueServiceRole"
},
"Resource": {
"Database": {
"Name": "tpc"
}
},
"Permissions": [
"CREATE_TABLE"
],
"PermissionsWithGrantOption": []
}
],
"NextToken": "E5SlJDSTZleUp6SWpvaU9UQTNORE0zTXpFeE5Ua3pJbjE5TENKbGVIQnBjbUYwYVc5dUlqcDdJbk5sWTI5dVpITWlPakUyTm=="
}
```
Weitere Informationen finden Sie unter [Verwalten von Lake-Formation-Berechtigungen](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ GetEffectivePermissionsForPath ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-effective-permissions-for-path.html) in der *AWS CLI Befehlsreferenz*.
### `get-lf-tag`
Das folgende Codebeispiel zeigt die Verwendung. `get-lf-tag`
**AWS CLI**
**Um eine LF-tag Definition abzurufen **
Das folgende `get-lf-tag` Beispiel ruft die LF-tag Definition ab.
```
aws lakeformation get-lf-tag \
--catalog-id '{{123456789111}}' \
--tag-key '{{usergroup}}'
```
Ausgabe:
```
{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"analyst",
"campaign",
"developer"
]
}
```
Weitere Informationen finden Sie unter [ Managing LF-Tags for metadata access control ](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) im *AWS Lake Formation Developer Guide*.
+ Einzelheiten zur API finden Sie [ GetLfTag ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-lf-tag.html) in der *AWS CLI Befehlsreferenz*.
### `get-query-state`
Das folgende Codebeispiel zeigt die Verwendung. `get-query-state`
**AWS CLI**
**So rufen Sie den Status einer gesendeten Abfrage ab**
Im folgenden Beispiel für `get-query-state` wird der Status einer zuvor übermittelten Abfrage zurückgegeben.
```
aws lakeformation get-query-state \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Ausgabe:
```
{
"State": "FINISHED"
}
```
Weitere Informationen finden Sie unter [Transaktionsdatenvorgänge](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ GetQueryState ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-query-state.html) in der *AWS CLI Befehlsreferenz*.
### `get-query-statistics`
Das folgende Codebeispiel zeigt die Verwendung. `get-query-statistics`
**AWS CLI**
**So rufen Sie Abfragestatistiken ab**
Im folgenden Beispiel für `get-query-statistics` werden Statistiken zur Planung und Ausführung einer Abfrage abgerufen.
```
aws lakeformation get-query-statistics \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Ausgabe:
```
{
"ExecutionStatistics": {
"AverageExecutionTimeMillis": 0,
"DataScannedBytes": 0,
"WorkUnitsExecutedCount": 0
},
"PlanningStatistics": {
"EstimatedDataToScanBytes": 43235,
"PlanningTimeMillis": 2377,
"QueueTimeMillis": 440,
"WorkUnitsGeneratedCount": 1
},
"QuerySubmissionTime": "2022-08-11T02:14:38.641870+00:00"
}
```
Weitere Informationen finden Sie unter [Transaktionsdatenvorgänge](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ GetQueryStatistics ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-query-statistics.html) in der *AWS CLI Befehlsreferenz*.
### `get-table-objects`
Das folgende Codebeispiel zeigt die Verwendung. `get-table-objects`
**AWS CLI**
**So listen Sie Objekte einer verwalteten Tabelle auf**
Im folgenden Beispiel für `get-table-objects` wird der Satz von Amazon-S3-Objekten zurückgegeben, aus denen die angegebene verwaltete Tabelle besteht.
```
aws lakeformation get-table-objects \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "012345678901",
"DatabaseName": "tpc",
"TableName": "dl_tpc_household_demographics_gov",
"QueryAsOfTime": "2022-08-10T15:00:00"
}
```
Ausgabe:
```
{
"Objects": [{
"PartitionValues": [],
"Objects": [{
"Uri": "s3://lf-data-lake-012345678901/target/dl_tpc_household_demographics_gov/run-unnamed-1-part-block-0-r-00000-snappy-ff26b17504414fe88b302cd795eabd00.parquet",
"ETag": "12345b1fc50a316b149b4e1f21a73800",
"Size": 43235
}]
}]
}
```
Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ GetTableObjects ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-table-objects.html) in der *AWS CLI Befehlsreferenz*.
### `get-work-unit-results`
Das folgende Codebeispiel zeigt die Verwendung. `get-work-unit-results`
**AWS CLI**
**So rufen Sie Arbeitseinheiten einer bestimmten Abfrage ab**
Im folgenden Beispiel für `get-work-unit-results` werden die Arbeitseinheiten zurückgegeben, die aus der Abfrage resultieren.
```
aws lakeformation get-work-units \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b' \
--work-unit-id '{{0}}' \
--work-unit-token '{{B2fMSdmQXe9umX8Ux8XCo4=}}' {{outfile}}
```
Ausgabe:
```
outfile with Blob content.
```
Weitere Informationen finden Sie unter [Transaktionsdatenvorgänge](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ GetWorkUnitResults ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-work-unit-results.html) in der *AWS CLI Befehlsreferenz*.
### `get-work-units`
Das folgende Codebeispiel zeigt die Verwendung. `get-work-units`
**AWS CLI**
**So rufen Sie Arbeitseinheiten ab**
Im folgenden `get-work-units` Beispiel werden die durch den StartQueryPlanning Vorgang generierten Arbeitseinheiten abgerufen.
```
aws lakeformation get-work-units \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Ausgabe:
```
{
"WorkUnitRanges": [{
"WorkUnitIdMax": 0,
"WorkUnitIdMin": 0,
"WorkUnitToken": "1234eMAk4kLO4umqEL4Z5WuxL04AXwABABVhd3MtY3J5cHRvLXB1YmxpYy1rZXkAREEwYm9QbkhINmFYTWphbmMxZW1PQmEyMGlUb0JFbXNlWmRYc0NmckRIR1dmQ0hjY2YzNFdMcmNXb2JGZmhEK0QvZz09AAEAB2F3cy1rbXMAS2Fybjphd3M6a21zOnVzLWVhc3QtMTo3MDkxNTAyNDkyNDk6a2V5L2VmYmI3NDUyLTY1MjYtNGJiOS1iNmZhLTEzYzJkMTM3MmU2OQC4AQIBAHg6eWNF2ZrQATTAuPDJVCEAQSyIF67vX+f88jzGrYq22gE6jkQlpOB+Oet2eqNUmFudAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQMCOEWRdafowek3RUmAgEQgDsYZZE84nnnbNmvsqCBPLh19nLQ10mUWOg9IfiaOwefEn6L920V0x1LpJACo7MtIBLXnbGcz2dFDZjFygIAAAAADAAAEAAAAAAAAAAAAAAAAAAQSQf8XDSI5pvR4Fx4JsrS/////wAAAAEAAAAAAAAAAAAAAAEAAACX3/w5h75QAPomfKH+cyEKYU1yccUmBl+VSojiGOtdsUk7vcjYXUUboYm3dvqRqX2s4gROMOn+Ij8R0/8jYmnHkpvyAFNVRPyETyIKg7k5Z9+5I1c2d3446Jw/moWGGxjH8AEG9h27ytmOhozxDOEi/F2ZoXz6wlGDfGUo/2WxCkYOhTyNaw6TM+7drTM7yrW4iNVLUM0LX0xnFjIAhLhooWJek6vjQZUAZzBlAjBH8okRtYP8R7AY2Wls/hqFBhG0V4l42AC0LxsuZbMQrE2SzWZUZ0E9Uew7/n0cyX4CMQDR79INyv4ysMByW9kKGGKyba+cCNklExMR+btBQBmMuB2fMSdmQXe9umX8Ux8XCo4="
}],
"QueryId": "1234273f-4a62-4cda-8d98-69615ee8be9b"
}
```
Weitere Informationen finden Sie unter [Transaktionsdatenvorgänge](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ GetWorkUnits ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-work-units.html) in der *AWS CLI Befehlsreferenz. *
### `Berechtigungen gewähren`
Das folgende Codebeispiel zeigt die Verwendung. `grant-permissions`
**AWS CLI**
**Beispiel 1: Um dem Prinzipal Berechtigungen für Ressourcen zu gewähren, verwenden Sie LF-Tags **
Im folgenden `grant-permissions` Beispiel werden dem Prinzipal ALLE Berechtigungen für eine Datenbankressource erteilt, die der LF-Tag Richtlinie entspricht.
```
aws lakeformation grant-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
},
"Resource": {
"LFTagPolicy": {
"CatalogId": "123456789111",
"ResourceType": "DATABASE",
"Expression": [{
"TagKey": "usergroup",
"TagValues": [
"analyst",
"developer"
]
}]
}
},
"Permissions": [
"ALL"
],
"PermissionsWithGrantOption": [
"ALL"
]
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
**Beispiel 2: So erteilen Sie dem Prinzipal Berechtigungen auf Spaltenebene**
Im folgenden Beispiel für `grant-permissions` wird dem Prinzipal die Berechtigung erteilt, eine bestimmte Spalte auszuwählen.
```
aws lakeformation grant-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"TableWithColumns": {
"CatalogId": "123456789111",
"ColumnNames": ["p_end_date_sk"],
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"Permissions": [
"SELECT"
],
"PermissionsWithGrantOption": []
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
**Beispiel 3: So erteilen Sie dem Prinzipal Tabellenberechtigungen**
Im folgenden Beispiel für `grant-permissions` wird dem Prinzipal die Auswahlberechtigung für alle Tabellen einer bestimmten Datenbank erteilt.
```
aws lakeformation grant-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"TableWildcard": {}
}
},
"Permissions": [
"SELECT"
],
"PermissionsWithGrantOption": []
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
**Beispiel 4: Um dem Prinzipal Berechtigungen LF-Tags zu erteilen **
Im folgenden `grant-permissions` Beispiel wird dem Principal die LF-Tags Erlaubnis eines Mitarbeiters erteilt.
```
aws lakeformation grant-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"LFTag": {
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"private", "public"
]
}
},
"Permissions": [
"ASSOCIATE"
],
"PermissionsWithGrantOption": []
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
**Beispiel 5: So erteilen Sie dem Prinzipal Berechtigungen für Datenspeicherorte**
Im folgenden Beispiel für `grant-permissions` wird dem Prinzipal die Berechtigung für Datenspeicherorte erteilt.
```
aws lakeformation grant-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"DataLocation": {
"CatalogId": "123456789111",
"ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111"
}
},
"Permissions": [
"DATA_LOCATION_ACCESS"
],
"PermissionsWithGrantOption": []
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ GrantPermissions ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/grant-permissions.html) in der *AWS CLI Befehlsreferenz*.
### `Daten-Zellen-Filter auflisten`
Das folgende Codebeispiel zeigt die Verwendung. `list-data-cells-filter`
**AWS CLI**
**So listen Sie Datenzellenfilter auf**
Im folgenden Beispiel für `list-data-cells-filter` wird ein Datenzellenfilter für eine bestimmte Tabelle aufgelistet.
```
aws lakeformation list-data-cells-filter \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"MaxResults": 2,
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
}
```
Ausgabe:
```
{
"DataCellsFilters": [{
"TableCatalogId": "123456789111",
"DatabaseName": "tpc",
"TableName": "dl_tpc_promotion",
"Name": "developer_promotion",
"RowFilter": {
"FilterExpression": "p_promo_name='ese'"
},
"ColumnNames": [
"p_channel_details",
"p_start_date_sk",
"p_purpose",
"p_promo_id",
"p_promo_name",
"p_end_date_sk",
"p_discount_active"
]
},
{
"TableCatalogId": "123456789111",
"DatabaseName": "tpc",
"TableName": "dl_tpc_promotion",
"Name": "developer_promotion_allrows",
"RowFilter": {
"FilterExpression": "TRUE",
"AllRowsWildcard": {}
},
"ColumnNames": [
"p_channel_details",
"p_start_date_sk",
"p_promo_name"
]
}
],
"NextToken": "2MDA2MTgwNiwibmFub3MiOjE0MDAwMDAwMH19"
}
```
Weitere Informationen finden Sie unter [Datenfilterung und Sicherheit auf Zellebene in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ ListDataCellsFilter ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-data-cells-filter.html) in der *AWS CLI Befehlsreferenz*.
### `list-lf-tags`
Das folgende Codebeispiel zeigt die Verwendung. `list-lf-tags`
**AWS CLI**
**Zur Liste LF-tags **
Das folgende `list-lf-tags` Beispiel gibt eine Liste zurück LF-tags , zu deren Anzeige der Anforderer berechtigt ist.
```
aws lakeformation list-lf-tags \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceShareType": "ALL",
"MaxResults": 2
}
```
Ausgabe:
```
{
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"private",
"public"
]
},
{
"CatalogId": "123456789111",
"TagKey": "group",
"TagValues": [
"analyst",
"campaign",
"developer"
]
}],
"NextToken": "kIiwiZXhwaXJhdGlvbiI6eyJzZWNvbmRzIjoxNjYwMDY4dCI6ZmFsc2V9"
}
```
Weitere Informationen finden Sie unter [ Managing LF-Tags for metadata access control ](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) im *AWS Lake Formation Developer Guide*.
+ Einzelheiten zur API finden Sie [ ListLfTags ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-lf-tags.html) in der *AWS CLI Befehlsreferenz*.
### `Berechtigungen auflisten`
Das folgende Codebeispiel zeigt die Verwendung. `list-permissions`
**AWS CLI**
**Beispiel 1: So rufen Sie die Liste der Prinzipal-Berechtigungen für die Ressource ab**
Im folgenden Beispiel für `list-permissions` wird eine Liste der Prinzipal-Berechtigungen für die Datenbankressourcen zurückgegeben.
```
aws lakeformation list-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceType": "DATABASE",
"MaxResults": 2
}
```
Ausgabe:
```
{
"PrincipalResourcePermissions": [{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-campaign-manager"
},
"Resource": {
"Database": {
"CatalogId": "123456789111",
"Name": "tpc"
}
},
"Permissions": [
"DESCRIBE"
],
"PermissionsWithGrantOption": []
}],
"NextToken": "E5SlJDSTZleUp6SWpvaU9UQTNORE0zTXpFeE5Ua3pJbjE5TENKbGVIQnBjbUYwYVc5dUlqcDdJbk5sWTI5dVpITWlPakUyTm"
}
```
Weitere Informationen finden Sie unter [Verwalten von Lake-Formation-Berechtigungen](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
**Beispiel 2: So rufen Sie die Liste der Prinzipal-Berechtigungen für die Tabelle mit Datenfiltern ab**
Im folgenden Beispiel für `list-permissions` werden die Berechtigungen für die Tabelle mit zugehörigen Datenfiltern aufgeführt, die dem Prinzipal gewährt wurden.
```
aws lakeformation list-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_customer"
}
},
"IncludeRelated": "TRUE",
"MaxResults": 10
}
```
Ausgabe:
```
{
"PrincipalResourcePermissions": [{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/Admin"
},
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "customer",
"Name": "customer_invoice"
}
},
"Permissions": [
"ALL",
"ALTER",
"DELETE",
"DESCRIBE",
"DROP",
"INSERT"
],
"PermissionsWithGrantOption": [
"ALL",
"ALTER",
"DELETE",
"DESCRIBE",
"DROP",
"INSERT"
]
},
{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/Admin"
},
"Resource": {
"TableWithColumns": {
"CatalogId": "123456789111",
"DatabaseName": "customer",
"Name": "customer_invoice",
"ColumnWildcard": {}
}
},
"Permissions": [
"SELECT"
],
"PermissionsWithGrantOption": [
"SELECT"
]
},
{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/Admin"
},
"Resource": {
"DataCellsFilter": {
"TableCatalogId": "123456789111",
"DatabaseName": "customer",
"TableName": "customer_invoice",
"Name": "dl_us_customer"
}
},
"Permissions": [
"DESCRIBE",
"SELECT",
"DROP"
],
"PermissionsWithGrantOption": []
}
],
"NextToken": "VyeUFjY291bnRQZXJtaXNzaW9ucyI6ZmFsc2V9"
}
```
Weitere Informationen finden Sie unter [Verwalten von Lake-Formation-Berechtigungen](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
**Beispiel 3: Um eine Liste der Hauptberechtigungen auf dem abzurufen LF-Tags **
Das folgende `list-permissions` Beispiel listet die Berechtigungen auf, die dem Prinzipal LF-Tags erteilt wurden.
```
aws lakeformation list-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"LFTag": {
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"private"
]
}
},
"MaxResults": 10
}
```
Ausgabe:
```
{
"PrincipalResourcePermissions": [{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
},
"Resource": {
"LFTag": {
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"*"
]
}
},
"Permissions": [
"DESCRIBE"
],
"PermissionsWithGrantOption": [
"DESCRIBE"
]
},
{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
},
"Resource": {
"LFTag": {
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"*"
]
}
},
"Permissions": [
"ASSOCIATE"
],
"PermissionsWithGrantOption": [
"ASSOCIATE"
]
}
],
"NextToken": "EJwY21GMGFXOXVJanA3SW5Ocm1pc3Npb25zIjpmYWxzZX0="
}
```
Weitere Informationen finden Sie unter [Verwalten von Lake-Formation-Berechtigungen](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ ListPermissions ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-permissions.html) in der *AWS CLI Befehlsreferenz*.
### `Ressourcen auflisten`
Das folgende Codebeispiel zeigt die Verwendung. `list-resources`
**AWS CLI**
**So listen Sie die von Lake Formation verwalteten Ressourcen auf**
Im folgenden Beispiel für `list-resources` werden die Ressourcen aufgelistet, die der von Lake Formation verwalteten Bedingung entsprechen.
```
aws lakeformation list-resources \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"FilterConditionList": [{
"Field": "ROLE_ARN",
"ComparisonOperator": "CONTAINS",
"StringValueList": [
"123456789111"
]
}],
"MaxResults": 10
}
```
Ausgabe:
```
{
"ResourceInfoList": [{
"ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111",
"RoleArn": "arn:aws:iam::123456789111:role/LF-GlueServiceRole",
"LastModified": "2022-07-21T02:12:46.669000+00:00"
},
{
"ResourceArn": "arn:aws:s3:::lf-emr-test-123456789111",
"RoleArn": "arn:aws:iam::123456789111:role/EMRLFS3Role",
"LastModified": "2022-07-29T16:22:03.211000+00:00"
}
]
}
```
Weitere Informationen finden Sie unter [Verwalten von Lake-Formation-Berechtigungen](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ ListResources ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-resources.html) in der *AWS CLI Befehlsreferenz*.
### `Transaktionen auflisten`
Das folgende Codebeispiel zeigt die Verwendung. `list-transactions`
**AWS CLI**
**So listen Sie alle Transaktionsdetails auf**
Im folgenden Beispiel für `list-transactions` werden Metadaten zu Transaktionen und deren Status zurückgegeben.
```
aws lakeformation list-transactions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"StatusFilter": "ALL",
"MaxResults": 3
}
```
Ausgabe:
```
{
"Transactions": [{
"TransactionId": "1234569f08804cb790d950d4d0fe485e",
"TransactionStatus": "committed",
"TransactionStartTime": "2022-08-10T14:32:29.220000+00:00",
"TransactionEndTime": "2022-08-10T14:32:33.751000+00:00"
},
{
"TransactionId": "12345972ca8347b89825e33c5774aec4",
"TransactionStatus": "committed",
"TransactionStartTime": "2022-08-10T14:29:04.046000+00:00",
"TransactionEndTime": "2022-08-10T14:29:09.681000+00:00"
},
{
"TransactionId": "12345daf6cb047dbba8ad9b0414613b2",
"TransactionStatus": "committed",
"TransactionStartTime": "2022-08-10T13:56:51.261000+00:00",
"TransactionEndTime": "2022-08-10T13:56:51.547000+00:00"
}
],
"NextToken": "77X1ebypsI7os+X2lhHsZLGNCDK3nNGpwRdFpicSOHgcX1/QMoniUAKcpR3kj3ts3PVdMA=="
}
```
Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ ListTransactions ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-transactions.html) in der *AWS CLI Befehlsreferenz*.
### `Put-Data-Lake-Einstellungen`
Das folgende Codebeispiel zeigt die Verwendung. `put-data-lake-settings`
**AWS CLI**
**So legen Sie die AWS Lake Formation-managed Data Lake-Einstellungen fest **
Im folgenden Beispiel für `put-data-lake-settings` werden die Liste der Data-Lake-Administratoren und andere Data-Lake-Einstellungen abgerufen.
```
aws lakeformation put-data-lake-settings \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"DataLakeSettings": {
"DataLakeAdmins": [{
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
}
],
"CreateDatabaseDefaultPermissions": [],
"CreateTableDefaultPermissions": [],
"TrustedResourceOwners": [],
"AllowExternalDataFiltering": true,
"ExternalDataFilteringAllowList": [{
"DataLakePrincipalIdentifier ": "123456789111"
}],
"AuthorizedSessionTagValueList": ["Amazon EMR"]
}
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Ändern der Standardsicherheitseinstellungen für Ihren Data Lake](https://docs.aws.amazon.com/lake-formation/latest/dg/change-settings.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ PutDataLakeSettings ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/put-data-lake-settings.html) in der *AWS CLI Befehlsreferenz*.
### `Ressource registrieren`
Das folgende Codebeispiel zeigt die Verwendung. `register-resource`
**AWS CLI**
**Beispiel 1: So registrieren Sie Data-Lake-Speicher mit der serviceverknüpften Rolle**
Im folgenden Beispiel für `register-resource` wird die Ressource mithilfe der serviceverknüpften Rolle entsprechend der Verwaltung durch Lake Formation registriert.
```
aws lakeformation register-resource \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
"UseServiceLinkedRole": true
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Hinzufügen eines Amazon-S3-Standorts zu Ihrem Data Lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) im *Entwicklerhandbuch für AWS Lake Formation*.
**Beispiel 2: So registrieren Sie Data-Lake-Speicher mit der serviceverknüpften Rolle**
Im folgenden Beispiel für `register-resource` wird die Ressource mit der benutzerdefinierten Rolle entsprechend der Verwaltung durch Lake Formation registriert.
```
aws lakeformation register-resource \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
"UseServiceLinkedRole": false,
"RoleArn": "arn:aws:iam::123456789111:role/LF-GlueServiceRole"
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Hinzufügen eines Amazon-S3-Standorts zu Ihrem Data Lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ RegisterResource ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/register-resource.html) in der *AWS CLI Befehlsreferenz*.
### `entferne die lf-tags aus der Ressource`
Das folgende Codebeispiel zeigt die Verwendung. `remove-lf-tags-from-resource`
**AWS CLI**
**Um es LF-Tag aus einer Ressource zu entfernen **
Im folgenden `remove-lf-tags-from-resource` Beispiel wird die LF-Tag Verknüpfung mit der Tabellenressource entfernt.
```
aws lakeformation remove-lf-tags-from-resource \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Ausgabe:
```
{
"Failures": []
}
```
Weitere Informationen finden Sie unter [ Zuweisen LF-Tags zu Datenkatalogressourcen ](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-assigning-tags.html) im *AWS Lake Formation Developer Guide*.
+ API-Details finden Sie [ RemoveLfTagsFromResource ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/remove-lf-tags-from-resource.html) in der *AWS CLI Befehlsreferenz. *
### `Berechtigungen widerrufen`
Das folgende Codebeispiel zeigt die Verwendung. `revoke-permissions`
**AWS CLI**
**So entziehen Sie dem Prinzipal Berechtigungen für Ressourcen**
Im folgenden Beispiel für `revoke-permissions` wird dem Prinzipal der Zugriff auf eine bestimmte Tabelle einer angegebenen Datenbank entzogen.
```
aws lakeformation revoke-permissions \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "123456789111",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"Permissions": [
"ALL"
],
"PermissionsWithGrantOption": []
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Gewähren und Widerrufen von Berechtigungen für Data-Catalog-Ressourcen](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ RevokePermissions ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/revoke-permissions.html) in der *AWS CLI Befehlsreferenz*.
### `Datenbanken nach LF-Tags durchsuchen`
Das folgende Codebeispiel zeigt die Verwendung. `search-databases-by-lf-tags`
**AWS CLI**
**So durchsuchen Sie Datenbankressourcen anhand von LF-Tags**
Im folgenden Beispiel für `search-databases-by-lf-tags` wird nach Datenbankressourcen gesucht, die dem LFTag-Ausdruck entsprechen.
```
aws lakeformation search-databases-by-lf-tags \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"MaxResults": 1,
"CatalogId": "123456789111",
"Expression": [{
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Ausgabe:
```
{
"DatabaseList": [{
"Database": {
"CatalogId": "123456789111",
"Name": "tpc"
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}]
}
```
Weitere Informationen finden Sie [ im *AWS Lake Formation Developer Guide unter *](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-view-tag-resources.html) Anzeigen der Ressourcen, denen a zugewiesen LF-Tag ist.
+ API-Details finden Sie [ SearchDatabasesByLfTags ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/search-databases-by-lf-tags.html) in der *AWS CLI Befehlsreferenz*.
### `Suchen Sie nach Tabellen nach LF-Tags`
Das folgende Codebeispiel zeigt die Verwendung. `search-tables-by-lf-tags`
**AWS CLI**
**So suchen Sie nach Tabellenressourcen anhand von LFTags**
Im folgenden Beispiel für `search-tables-by-lf-tags` wird nach Tabellenressourcen gesucht, die dem LFTag-Ausdruck entsprechen.
```
aws lakeformation search-tables-by-lf-tags \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"MaxResults": 2,
"CatalogId": "123456789111",
"Expression": [{
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Ausgabe:
```
{
"NextToken": "c2VhcmNoQWxsVGFnc0luVGFibGVzIjpmYWxzZX0=",
"TableList": [{
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_item"
},
"LFTagOnDatabase": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}],
"LFTagsOnTable": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}],
"LFTagsOnColumns": [{
"Name": "i_item_desc",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_container",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_wholesale_cost",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_manufact_id",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_brand_id",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_formulation",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_current_price",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_size",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_rec_start_date",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_manufact",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_item_sk",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_manager_id",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_item_id",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_class_id",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_class",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_category",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_category_id",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_brand",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_units",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_rec_end_date",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_color",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
},
{
"Name": "i_product_name",
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
]
}]
}
```
Weitere Informationen finden Sie [ im *AWS Lake Formation Developer Guide unter *](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-view-tag-resources.html) Anzeigen der Ressourcen, denen a zugewiesen LF-Tag ist.
+ API-Details finden Sie [ SearchTablesByLfTags ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/search-tables-by-lf-tags.html) in der *AWS CLI Befehlsreferenz*.
### `Starten Sie die Abfrageplanung`
Das folgende Codebeispiel zeigt die Verwendung. `start-query-planning`
**AWS CLI**
**So verarbeiten Sie die Abfrageanweisung**
Im folgenden Beispiel für `start-query-planning` wird eine Anforderung zur Verarbeitung einer Abfrageanweisung gesendet.
```
aws lakeformation start-query-planning \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"QueryPlanningContext": {
"CatalogId": "012345678901",
"DatabaseName": "tpc"
},
"QueryString": "select * from dl_tpc_household_demographics_gov where hd_income_band_sk=9"
}
```
Ausgabe:
```
{
"QueryId": "772a273f-4a62-4cda-8d98-69615ee8be9b"
}
```
Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ StartQueryPlanning ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/start-query-planning.html) in der *AWS CLI Befehlsreferenz*.
### `Transaktion starten`
Das folgende Codebeispiel zeigt die Verwendung. `start-transaction`
**AWS CLI**
**So starten Sie eine neue Transaktion**
Im folgenden Beispiel für `start-transaction` wird eine neue Transaktion gestartet und ihre Transaktions-ID zurückgegeben.
```
aws lakeformation start-transaction \
--transaction-type {{=}} '{{READ_AND_WRITE}}'
```
Ausgabe:
```
{
"TransactionId": "b014d972ca8347b89825e33c5774aec4"
}
```
Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ StartTransaction ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/start-transaction.html) in der *AWS CLI Befehlsreferenz*.
### `update-lf-tag`
Das folgende Codebeispiel zeigt die Verwendung. `update-lf-tag`
**AWS CLI**
**Um die LF-Tag Definition zu aktualisieren **
Das folgende `update-lf-tag` Beispiel aktualisiert die LF-Tag Definition.
```
aws lakeformation update-lf-tag \
--catalog-id '{{123456789111}}' \
--tag-key '{{usergroup}}' \
--tag-values-to-add '{{["admin"]}}'
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [ Managing LF-Tags for metadata access control ](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) im *AWS Lake Formation Developer Guide*.
+ Einzelheiten zur API finden Sie [ UpdateLfTag ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/update-lf-tag.html) in der *AWS CLI Befehlsreferenz*.
### `Tabellenobjekte aktualisieren`
Das folgende Codebeispiel zeigt die Verwendung. `update-table-objects`
**AWS CLI**
**So ändern Sie Objekte einer verwalteten Tabelle**
Im folgenden Beispiel für `update-table-objects` werden der angegebenen verwalteten Tabelle bereitgestellte S3-Objekte hinzugefügt.
```
aws lakeformation update-table-objects \
--cli-input-json {{file://input.json}}
```
Inhalt von `input.json`:
```
{
"CatalogId": "012345678901",
"DatabaseName": "tpc",
"TableName": "dl_tpc_household_demographics_gov",
"TransactionId": "12347a9f75424b9b915f6ff201d2a190",
"WriteOperations": [{
"AddObject": {
"Uri": "s3://lf-data-lake-012345678901/target/dl_tpc_household_demographics_gov/run-unnamed-1-part-block-0-r-00000-snappy-ff26b17504414fe88b302cd795eabd00.parquet",
"ETag": "1234ab1fc50a316b149b4e1f21a73800",
"Size": 42200
}
}]
}
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen finden Sie unter [Lesen aus dem Data Lake und Schreiben in den Data Lake während Transaktionen](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) im *Entwicklerhandbuch für AWS Lake Formation*.
+ API-Details finden Sie [ UpdateTableObjects ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/update-table-objects.html) in der *AWS CLI Befehlsreferenz*.