Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Esempi di Lake Formation utilizzando AWS CLI
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with Lake Formation.
Le *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.
**Topics**
+ [Azioni](#actions)
## Azioni
### `add-lf-tags-to-resource`
Il seguente esempio di codice mostra come utilizzare`add-lf-tags-to-resource`.
**AWS CLI**
**Come aggiungere uno o più tag LF a una risorsa esistente**
L’esempio `add-lf-tags-to-resource` seguente aggiunge un determinato tag LF alla risorsa della tabella.
```
aws lakeformation add-lf-tags-to-resource \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"analyst"
]
}]
}
```
Output:
```
{
"Failures": []
}
```
Per ulteriori informazioni, consulta [Assegnazione di tag LF alle risorse del Catalogo dati](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-assigning-tags.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [AddLfTagsToResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/add-lf-tags-to-resource.html)*Command Reference*.
### `batch-grant-permissions`
Il seguente esempio di codice mostra come utilizzare`batch-grant-permissions`.
**AWS CLI**
**Come concedere in blocco le autorizzazioni sulle risorse ai principali**
L’esempio `batch-grant-permissions` seguente concede in blocco ai principali l’accesso a risorse specifiche.
```
aws lakeformation batch-grant-permissions \
--cli-input-json file://input.json
```
Contenuto di `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": []
}
]
}
```
Output:
```
{
"Failures": []
}
```
Per ulteriori informazioni sulla concessione e la revoca dell’accesso a Lake Formation, consulta la pagina [Concessione e revoca delle autorizzazioni delle risorse del catalogo dati](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) nella *Guida per gli sviluppatori di AWS *.
+ Per i dettagli sull'API, consulta [BatchGrantPermissions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/batch-grant-permissions.html)*Command Reference*.
### `batch-revoke-permissions`
Il seguente esempio di codice mostra come utilizzare`batch-revoke-permissions`.
**AWS CLI**
**Come revocare in blocco le autorizzazioni sulle risorse ai principali**
L’esempio `batch-revoke-permissions` seguente revoca in blocco ai principali l’accesso a risorse specifiche.
```
aws lakeformation batch-revoke-permissions \
--cli-input-json file://input.json
```
Contenuto di `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"
]
}
]
}
```
Output:
```
{
"Failures": []
}
```
Per ulteriori informazioni sulla concessione e la revoca dell’accesso a Lake Formation, consulta la pagina [Concessione e revoca delle autorizzazioni delle risorse del catalogo dati](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) nella *Guida per gli sviluppatori di AWS *.
+ Per i dettagli sull'API, consulta [BatchRevokePermissions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/batch-revoke-permissions.html)*Command Reference*.
### `cancel-transaction`
Il seguente esempio di codice mostra come utilizzare`cancel-transaction`.
**AWS CLI**
**Come annullare una transazione**
L’esempio `cancel-transaction` seguente annulla la transazione.
```
aws lakeformation cancel-transaction \
--transaction-id='b014d972ca8347b89825e33c5774aec4'
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Lettura e scrittura di dati nel data lake all’interno delle transazioni](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [CancelTransaction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/cancel-transaction.html)*Command Reference*.
### `commit-transaction`
Il seguente esempio di codice mostra come utilizzare`commit-transaction`.
**AWS CLI**
**Come confermare una transazione**
L’esempio `commit-transaction` seguente conferma la transazione.
```
aws lakeformation commit-transaction \
--transaction-id='b014d972ca8347b89825e33c5774aec4'
```
Output:
```
{
"TransactionStatus": "committed"
}
```
Per ulteriori informazioni, consulta [Lettura e scrittura di dati nel data lake all’interno delle transazioni](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [CommitTransaction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/commit-transaction.html)*Command Reference*.
### `create-data-cells-filter`
Il seguente esempio di codice mostra come utilizzare`create-data-cells-filter`.
**AWS CLI**
**Esempio 1: come creare un filtro per le celle di dati**
L’esempio `create-data-cells-filter` seguente crea un filtro sulle celle di dati per consentire l’accesso a determinate colonne in base alle condizioni della riga.
```
aws lakeformation create-data-cells-filter \
--cli-input-json file://input.json
```
Contenuto di `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"
}
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Filtro dei dati e sicurezza a livello di cella in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
**Esempio 2: come creare un filtro per le colonne**
L’esempio `create-data-cells-filter` seguente crea un filtro dati per consentire l’accesso a determinate colonne.
```
aws lakeformation create-data-cells-filter \
--cli-input-json file://input.json
```
Contenuto di `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"
}
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Filtro dei dati e sicurezza a livello di cella in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
**Esempio 3: come creare un filtro dati con colonne di esclusione**
L’esempio `create-data-cells-filter` seguente crea un filtro dati per consentire l’accesso a tutte le colonne tranne quelle menzionate.
```
aws lakeformation create-data-cells-filter \
--cli-input-json file://input.json
```
Contenuto di `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"
}
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Filtro dei dati e sicurezza a livello di cella in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [CreateDataCellsFilter AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/create-data-cells-filter.html)*Command Reference*.
### `create-lf-tag`
Il seguente esempio di codice mostra come utilizzare`create-lf-tag`.
**AWS CLI**
**Come creare un tag LF**
L’esempio `create-lf-tag` seguente crea un tag LF con il nome e i valori specificati.
```
aws lakeformation create-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup' \
--tag-values '["developer","analyst","campaign"]'
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Gestione dei tag LF per il controllo dell’accesso ai metadati](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [CreateLfTag AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/create-lf-tag.html)*Command Reference*.
### `delete-data-cells-filter`
Il seguente esempio di codice mostra come utilizzare`delete-data-cells-filter`.
**AWS CLI**
**Come eliminare il filtro per le celle di dati**
L’esempio `delete-data-cells-filter` seguente elimina un determinato filtro per le celle di dati.
```
aws lakeformation delete-data-cells-filter \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"TableCatalogId": "123456789111",
"DatabaseName": "tpc",
"TableName": "dl_tpc_promotion",
"Name": "developer_promotion"
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Filtro dei dati e sicurezza a livello di cella in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [DeleteDataCellsFilter AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-data-cells-filter.html)*Command Reference*.
### `delete-lf-tag`
Il seguente esempio di codice mostra come utilizzare`delete-lf-tag`.
**AWS CLI**
**Come eliminare la definizione del tag LF**
L’esempio `delete-lf-tag` seguente elimina la definizione del tag LF.
```
aws lakeformation delete-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup'
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Gestione dei tag LF per il controllo dell’accesso ai metadati](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [DeleteLfTag AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-lf-tag.html)*Command Reference*.
### `delete-objects-on-cancel`
Il seguente esempio di codice mostra come utilizzare`delete-objects-on-cancel`.
**AWS CLI**
**Come eliminare l’oggetto quando la transazione viene annullata**
L’esempio `delete-objects-on-cancel` seguente elimina l’oggetto s3 elencato quando la transazione viene annullata.
```
aws lakeformation delete-objects-on-cancel \
--cli-input-json file://input.json
```
Contenuto di `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"
}]
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Lettura e scrittura di dati nel data lake all’interno delle transazioni](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [DeleteObjectsOnCancel AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-objects-on-cancel.html)*Command Reference*.
### `deregister-resource`
Il seguente esempio di codice mostra come utilizzare`deregister-resource`.
**AWS CLI**
**Come annullare la registrazione dell’archiviazione nel data lake**
L’esempio `deregister-resource` seguente annulla la registrazione della risorsa come gestita da Lake Formation.
```
aws lakeformation deregister-resource \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123"
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Aggiunta di una posizione Amazon S3 al data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [DeregisterResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/deregister-resource.html)*Command Reference*.
### `describe-transaction`
Il seguente esempio di codice mostra come utilizzare`describe-transaction`.
**AWS CLI**
**Come recuperare i dettagli di una transazione**
L’esempio `describe-transaction` seguente restituisce i dettagli di una singola transazione.
```
aws lakeformation describe-transaction \
--transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce'
```
Output:
```
{
"TransactionDescription": {
"TransactionId": "12345972ca8347b89825e33c5774aec4",
"TransactionStatus": "committed",
"TransactionStartTime": "2022-08-10T14:29:04.046000+00:00",
"TransactionEndTime": "2022-08-10T14:29:09.681000+00:00"
}
}
```
Per ulteriori informazioni, consulta [Lettura e scrittura di dati nel data lake all’interno delle transazioni](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [DescribeTransaction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/describe-transaction.html)*Command Reference*.
### `extend-transaction`
Il seguente esempio di codice mostra come utilizzare`extend-transaction`.
**AWS CLI**
**Come estendere una transazione**
L’esempio `extend-transaction` seguente estende la transazione.
```
aws lakeformation extend-transaction \
--transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce'
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Lettura e scrittura di dati nel data lake all’interno delle transazioni](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [ExtendTransaction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/extend-transaction.html)*Command Reference*.
### `get-data-lake-settings`
Il seguente esempio di codice mostra come utilizzare`get-data-lake-settings`.
**AWS CLI**
**Per recuperare le impostazioni AWS del data lake gestite da Lake Formation**
L’esempio `get-data-lake-settings` seguente recupera l’elenco degli amministratori del data lake e altre impostazioni del data lake.
```
aws lakeformation get-data-lake-settings \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "123456789111"
}
```
Output:
```
{
"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"
]
}
}
```
Per ulteriori informazioni, consulta [Modifica delle impostazioni di sicurezza predefinite per il data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/change-settings.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ *Per i dettagli sull'API, consulta [GetDataLakeSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-data-lake-settings.html)Command Reference.AWS CLI *
### `get-effective-permissions-for-path`
Il seguente esempio di codice mostra come utilizzare`get-effective-permissions-for-path`.
**AWS CLI**
**Come recuperare le autorizzazioni sulle risorse che si trovano in un percorso specifico**
L’esempio `get-effective-permissions-for-path` seguente restituisce le autorizzazioni di Lake Formation per una risorsa della tabella o del database specificata situata in un percorso in Amazon S3.
```
aws lakeformation get-effective-permissions-for-path \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111"
}
```
Output:
```
{
"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=="
}
```
Per ulteriori informazioni, consulta [Gestione delle autorizzazioni di Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [GetEffectivePermissionsForPath AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-effective-permissions-for-path.html)*Command Reference*.
### `get-lf-tag`
Il seguente esempio di codice mostra come utilizzare`get-lf-tag`.
**AWS CLI**
**Come recuperare la definizione del tag LF**
L’esempio `get-lf-tag` seguente recupera la definizione del tag LF.
```
aws lakeformation get-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup'
```
Output:
```
{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"analyst",
"campaign",
"developer"
]
}
```
Per ulteriori informazioni, consulta [Gestione dei tag LF per il controllo dell’accesso ai metadati](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [GetLfTag AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-lf-tag.html)*Command Reference*.
### `get-query-state`
Il seguente esempio di codice mostra come utilizzare`get-query-state`.
**AWS CLI**
**Come recuperare lo stato di una query inviata**
L’esempio `get-query-state` seguente restituisce lo stato di una query inviata in precedenza.
```
aws lakeformation get-query-state \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Output:
```
{
"State": "FINISHED"
}
```
Per ulteriori informazioni, consulta [Operazioni sui dati transazionali](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [GetQueryState AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-query-state.html)*Command Reference*.
### `get-query-statistics`
Il seguente esempio di codice mostra come utilizzare`get-query-statistics`.
**AWS CLI**
**Come recuperare le statistiche delle query**
L’esempio `get-query-statistics` seguente recupera le statistiche sulla pianificazione e l’esecuzione di una query.
```
aws lakeformation get-query-statistics \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Output:
```
{
"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"
}
```
Per ulteriori informazioni, consulta [Operazioni sui dati transazionali](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [GetQueryStatistics AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-query-statistics.html)*Command Reference*.
### `get-resource-lf-tags`
Il seguente esempio di codice mostra come utilizzare`get-resource-lf-tags`.
**AWS CLI**
**Come elencare i tag LF**
L’esempio `list-lf-tags` seguente restituisce un elenco di tag LF che il richiedente è autorizzato a visualizzare.
```
aws lakeformation list-lf-tags \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceShareType": "ALL",
"MaxResults": 2
}
```
Output:
```
{
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"private",
"public"
]
},
{
"CatalogId": "123456789111",
"TagKey": "group",
"TagValues": [
"analyst",
"campaign",
"developer"
]
}],
"NextToken": "kIiwiZXhwaXJhdGlvbiI6eyJzZWNvbmRzIjoxNjYwMDY4dCI6ZmFsc2V9"
}
```
Per ulteriori informazioni, consulta [Gestione dei tag LF per il controllo dell’accesso ai metadati](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [GetResourceLfTags AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-resource-lf-tags.html)*Command Reference*.
### `get-table-objects`
Il seguente esempio di codice mostra come utilizzare`get-table-objects`.
**AWS CLI**
**Come elencare gli oggetti di una tabella governata**
L’esempio `get-table-objects` seguente restituisce l’insieme di oggetti Amazon S3 che costituiscono la tabella governata specificata.
```
aws lakeformation get-table-objects \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "012345678901",
"DatabaseName": "tpc",
"TableName": "dl_tpc_household_demographics_gov",
"QueryAsOfTime": "2022-08-10T15:00:00"
}
```
Output:
```
{
"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
}]
}]
}
```
Per ulteriori informazioni, consulta [Lettura e scrittura di dati nel data lake all’interno delle transazioni](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [GetTableObjects AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-table-objects.html)*Command Reference*.
### `get-work-unit-results`
Il seguente esempio di codice mostra come utilizzare`get-work-unit-results`.
**AWS CLI**
**Come recuperare le unità di lavoro di una determinata query**
L’esempio `get-work-unit-results` seguente restituisce le unità di lavoro risultanti dalla query.
```
aws lakeformation get-work-units \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b' \
--work-unit-id '0' \
--work-unit-token 'B2fMSdmQXe9umX8Ux8XCo4=' outfile
```
Output:
```
outfile with Blob content.
```
Per ulteriori informazioni, consulta [Operazioni sui dati transazionali](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [GetWorkUnitResults AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-work-unit-results.html)*Command Reference*.
### `get-work-units`
Il seguente esempio di codice mostra come utilizzare`get-work-units`.
**AWS CLI**
**Come recuperare le unità di lavoro**
L'`get-work-units`esempio seguente recupera le unità di lavoro generate dall' StartQueryPlanning operazione.
```
aws lakeformation get-work-units \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Output:
```
{
"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"
}
```
Per ulteriori informazioni, consulta [Operazioni sui dati transazionali](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, vedere [GetWorkUnits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-work-units.html)in *AWS CLI Command Reference.*
### `grant-permissions`
Il seguente esempio di codice mostra come utilizzare`grant-permissions`.
**AWS CLI**
**Esempio 1: come concedere al responsabile le autorizzazioni sulle risorse utilizzando i tag LF**
L’esempio `grant-permissions` seguente concede al responsabile TUTTE le autorizzazioni sulla risorsa di database che corrisponde alla policy sui tag LF.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Contenuto di `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"
]
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni sulla concessione e la revoca dell’accesso a Lake Formation, consulta la pagina [Concessione e revoca delle autorizzazioni delle risorse del catalogo dati](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) nella *Guida per gli sviluppatori di AWS *.
**Esempio 2: come concedere al responsabile le autorizzazioni a livello di colonna**
L’esempio `grant-permissions` seguente concede al responsabile l’autorizzazione a selezionare una colonna specifica.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Contenuto di `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": []
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni sulla concessione e la revoca dell’accesso a Lake Formation, consulta la pagina [Concessione e revoca delle autorizzazioni delle risorse del catalogo dati](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) nella *Guida per gli sviluppatori di AWS *.
**Esempio 3: come concedere al responsabile le autorizzazioni per le tabelle**
L’esempio `grant-permissions` seguente concede al responsabile l’autorizzazione per la selezione su tutte le tabelle di un determinato database.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "123456789111",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"TableWildcard": {}
}
},
"Permissions": [
"SELECT"
],
"PermissionsWithGrantOption": []
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni sulla concessione e la revoca dell’accesso a Lake Formation, consulta la pagina [Concessione e revoca delle autorizzazioni delle risorse del catalogo dati](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) nella *Guida per gli sviluppatori di AWS *.
**Esempio 4: come concedere al responsabile le autorizzazioni sui tag LF**
L’esempio `grant-permissions` seguente concede al responsabile l’autorizzazione per l’associazione sui tag LF.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Contenuto di `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": []
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni sulla concessione e la revoca dell’accesso a Lake Formation, consulta la pagina [Concessione e revoca delle autorizzazioni delle risorse del catalogo dati](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) nella *Guida per gli sviluppatori di AWS *.
**Esempio 5: come concedere al responsabile le autorizzazioni sulle posizioni dei dati**
L’esempio `grant-permissions` seguente concede al responsabile l’autorizzazione sulla posizione dei dati.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Contenuto di `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": []
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni sulla concessione e la revoca dell’accesso a Lake Formation, consulta la pagina [Concessione e revoca delle autorizzazioni delle risorse del catalogo dati](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) nella *Guida per gli sviluppatori di AWS *.
+ Per i dettagli sull'API, consulta [GrantPermissions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/grant-permissions.html)*Command Reference*.
### `list-data-cells-filter`
Il seguente esempio di codice mostra come utilizzare`list-data-cells-filter`.
**AWS CLI**
**Come elencare i filtri delle celle di dati**
L’esempio `list-data-cells-filter` seguente elenca il filtro delle celle di dati per una determinata tabella.
```
aws lakeformation list-data-cells-filter \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"MaxResults": 2,
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
}
```
Output:
```
{
"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"
}
```
Per ulteriori informazioni, consulta [Filtro dei dati e sicurezza a livello di cella in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [ListDataCellsFilter AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-data-cells-filter.html)*Command Reference*.
### `list-permissions`
Il seguente esempio di codice mostra come utilizzare`list-permissions`.
**AWS CLI**
**Esempio 1: come recuperare l’elenco delle autorizzazioni del responsabile sulla risorsa**
L’esempio `list-permissions` seguente restituisce un elenco delle autorizzazioni del responsabile sulle risorse del database.
```
aws lakeformation list-permissions \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceType": "DATABASE",
"MaxResults": 2
}
```
Output:
```
{
"PrincipalResourcePermissions": [{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-campaign-manager"
},
"Resource": {
"Database": {
"CatalogId": "123456789111",
"Name": "tpc"
}
},
"Permissions": [
"DESCRIBE"
],
"PermissionsWithGrantOption": []
}],
"NextToken": "E5SlJDSTZleUp6SWpvaU9UQTNORE0zTXpFeE5Ua3pJbjE5TENKbGVIQnBjbUYwYVc5dUlqcDdJbk5sWTI5dVpITWlPakUyTm"
}
```
Per ulteriori informazioni, consulta [Gestione delle autorizzazioni di Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
**Esempio 2: come recuperare l’elenco delle autorizzazioni del responsabile sulla tabella con filtri di dati**
L’esempio `list-permissions` seguente elenca le autorizzazioni sulla tabella con i relativi filtri di dati concesse al responsabile.
```
aws lakeformation list-permissions \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_customer"
}
},
"IncludeRelated": "TRUE",
"MaxResults": 10
}
```
Output:
```
{
"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"
}
```
Per ulteriori informazioni, consulta [Gestione delle autorizzazioni di Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
**Esempio 3: come recuperare l’elenco delle autorizzazioni del responsabile sui tag LF**
L’esempio `list-permissions` seguente elenca le autorizzazioni sui tag LF concesse al responsabile.
```
aws lakeformation list-permissions \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"LFTag": {
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"private"
]
}
},
"MaxResults": 10
}
```
Output:
```
{
"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="
}
```
Per ulteriori informazioni, consulta [Gestione delle autorizzazioni di Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [ListPermissions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-permissions.html)*Command Reference*.
### `list-resources`
Il seguente esempio di codice mostra come utilizzare`list-resources`.
**AWS CLI**
**Come elencare le risorse gestite da Lake Formation**
L’esempio `list-resources` seguente elenca le risorse che corrispondono alla condizione gestita da Lake Formation.
```
aws lakeformation list-resources \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"FilterConditionList": [{
"Field": "ROLE_ARN",
"ComparisonOperator": "CONTAINS",
"StringValueList": [
"123456789111"
]
}],
"MaxResults": 10
}
```
Output:
```
{
"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"
}
]
}
```
Per ulteriori informazioni, consulta [Gestione delle autorizzazioni di Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [ListResources AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-resources.html)*Command Reference*.
### `list-transactions`
Il seguente esempio di codice mostra come utilizzare`list-transactions`.
**AWS CLI**
**Come elencare tutti i dettagli delle transazioni**
L’esempio `list-transactions` seguente restituisce i metadati relativi alle transazioni e al loro stato.
```
aws lakeformation list-transactions \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "123456789111",
"StatusFilter": "ALL",
"MaxResults": 3
}
```
Output:
```
{
"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=="
}
```
Per ulteriori informazioni, consulta [Lettura e scrittura di dati nel data lake all’interno delle transazioni](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [ListTransactions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-transactions.html)*Command Reference*.
### `put-data-lake-settings`
Il seguente esempio di codice mostra come utilizzare`put-data-lake-settings`.
**AWS CLI**
**Per configurare le impostazioni AWS del data lake gestito da Lake Formation**
L’esempio `put-data-lake-settings` seguente imposta l’elenco degli amministratori del data lake e altre impostazioni del data lake.
```
aws lakeformation put-data-lake-settings \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"DataLakeSettings": {
"DataLakeAdmins": [{
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
}
],
"CreateDatabaseDefaultPermissions": [],
"CreateTableDefaultPermissions": [],
"TrustedResourceOwners": [],
"AllowExternalDataFiltering": true,
"ExternalDataFilteringAllowList": [{
"DataLakePrincipalIdentifier ": "123456789111"
}],
"AuthorizedSessionTagValueList": ["Amazon EMR"]
}
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Modifica delle impostazioni di sicurezza predefinite per il data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/change-settings.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ *Per i dettagli sull'API, consulta Command [PutDataLakeSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/put-data-lake-settings.html)Reference AWS CLI .*
### `register-resource`
Il seguente esempio di codice mostra come utilizzare`register-resource`.
**AWS CLI**
**Esempio 1: come registrare l’archiviazione nel data lake utilizzando un ruolo collegato ai servizi**
L’esempio `register-resource` seguente registra la risorsa come gestita da Lake Formation utilizzando un ruolo collegato ai servizi.
```
aws lakeformation register-resource \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
"UseServiceLinkedRole": true
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Aggiunta di una posizione Amazon S3 al data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
**Esempio 2: come registrare l’archiviazione nel data lake utilizzando una regola personalizzata**
L’esempio `register-resource` seguente registra la risorsa come gestita da Lake Formation utilizzando un ruolo personalizzato.
```
aws lakeformation register-resource \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
"UseServiceLinkedRole": false,
"RoleArn": "arn:aws:iam::123456789111:role/LF-GlueServiceRole"
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Aggiunta di una posizione Amazon S3 al data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [RegisterResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/register-resource.html)*Command Reference*.
### `remove-lf-tags-from-resource`
Il seguente esempio di codice mostra come utilizzare`remove-lf-tags-from-resource`.
**AWS CLI**
**Come rimuovere il tag LF da una risorsa**
L’esempio `remove-lf-tags-from-resource` seguente rimuove l’associazione tra il tag LF e la risorsa della tabella.
```
aws lakeformation remove-lf-tags-from-resource \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Output:
```
{
"Failures": []
}
```
Per ulteriori informazioni, consulta [Assegnazione di tag LF alle risorse del Catalogo dati](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-assigning-tags.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [RemoveLfTagsFromResource AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/remove-lf-tags-from-resource.html)*Command Reference*.
### `revoke-permissions`
Il seguente esempio di codice mostra come utilizzare`revoke-permissions`.
**AWS CLI**
**Come revocare al responsabile le autorizzazioni sulle risorse**
L’esempio `revoke-permissions` seguente revoca al responsabile l’accesso a una tabella specifica di un determinato database.
```
aws lakeformation revoke-permissions \
--cli-input-json file://input.json
```
Contenuto di `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": []
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni sulla concessione e la revoca dell’accesso a Lake Formation, consulta la pagina [Concessione e revoca delle autorizzazioni delle risorse del catalogo dati](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) nella *Guida per gli sviluppatori di AWS *.
+ Per i dettagli sull'API, consulta [RevokePermissions AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/revoke-permissions.html)*Command Reference*.
### `search-databases-by-lf-tags`
Il seguente esempio di codice mostra come utilizzare`search-databases-by-lf-tags`.
**AWS CLI**
**Per cercare nelle risorse del database per LFTags**
L'`search-databases-by-lf-tags`esempio seguente cerca le risorse del database che corrispondono all' LFTag espressione.
```
aws lakeformation search-databases-by-lf-tags \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"MaxResults": 1,
"CatalogId": "123456789111",
"Expression": [{
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Output:
```
{
"DatabaseList": [{
"Database": {
"CatalogId": "123456789111",
"Name": "tpc"
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}]
}
```
Per ulteriori informazioni, consulta [Visualizzazione delle risorse a cui è assegnato un tag LF](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-view-tag-resources.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, vedere [SearchDatabasesByLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/search-databases-by-lf-tags.html)in *AWS CLI Command Reference*.
### `search-tables-by-lf-tags`
Il seguente esempio di codice mostra come utilizzare`search-tables-by-lf-tags`.
**AWS CLI**
**Per cercare nelle risorse della tabella per LFTags**
L'`search-tables-by-lf-tags`esempio seguente esegue una ricerca sulle risorse della tabella che corrispondono all' LFTag espressione.
```
aws lakeformation search-tables-by-lf-tags \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"MaxResults": 2,
"CatalogId": "123456789111",
"Expression": [{
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Output:
```
{
"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"
]
}]
}
]
}]
}
```
Per ulteriori informazioni, consulta [Visualizzazione delle risorse a cui è assegnato un tag LF](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-view-tag-resources.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, vedere [SearchTablesByLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/search-tables-by-lf-tags.html)in *AWS CLI Command Reference*.
### `start-query-planning`
Il seguente esempio di codice mostra come utilizzare`start-query-planning`.
**AWS CLI**
**Come elaborare l’istruzione di una query**
L’esempio `start-query-planning` seguente invia una richiesta per elaborare l’istruzione di una query.
```
aws lakeformation start-query-planning \
--cli-input-json file://input.json
```
Contenuto di `input.json`:
```
{
"QueryPlanningContext": {
"CatalogId": "012345678901",
"DatabaseName": "tpc"
},
"QueryString": "select * from dl_tpc_household_demographics_gov where hd_income_band_sk=9"
}
```
Output:
```
{
"QueryId": "772a273f-4a62-4cda-8d98-69615ee8be9b"
}
```
Per ulteriori informazioni, consulta [Lettura e scrittura di dati nel data lake all’interno delle transazioni](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [StartQueryPlanning AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/start-query-planning.html)*Command Reference*.
### `start-transaction`
Il seguente esempio di codice mostra come utilizzare`start-transaction`.
**AWS CLI**
**Come avviare una nuova transazione**
L’esempio `start-transaction` seguente avvia una nuova transazione e restituisce il relativo ID.
```
aws lakeformation start-transaction \
--transaction-type = 'READ_AND_WRITE'
```
Output:
```
{
"TransactionId": "b014d972ca8347b89825e33c5774aec4"
}
```
Per ulteriori informazioni, consulta [Lettura e scrittura di dati nel data lake all’interno delle transazioni](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [StartTransaction AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/start-transaction.html)*Command Reference*.
### `update-lf-tag`
Il seguente esempio di codice mostra come utilizzare`update-lf-tag`.
**AWS CLI**
**Come aggiornare la definizione del tag LF**
L’esempio `update-lf-tag` seguente aggiorna la definizione del tag LF.
```
aws lakeformation update-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup' \
--tag-values-to-add '["admin"]'
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Gestione dei tag LF per il controllo dell’accesso ai metadati](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [UpdateLfTag AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/update-lf-tag.html)*Command Reference*.
### `update-table-objects`
Il seguente esempio di codice mostra come utilizzare`update-table-objects`.
**AWS CLI**
**Come modificare gli oggetti della tabella governata**
L’esempio `update-table-objects` seguente aggiunge gli oggetti S3 forniti alla tabella governata specificata.
```
aws lakeformation update-table-objects \
--cli-input-json file://input.json
```
Contenuto di `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
}
}]
}
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Lettura e scrittura di dati nel data lake all’interno delle transazioni](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) nella *Guida per gli sviluppatori di AWS Lake Formation*.
+ Per i dettagli sull'API, consulta [UpdateTableObjects AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/update-table-objects.html)*Command Reference*.