Esempi di Lake Formation utilizzando AWS CLI - AWS Command Line Interface
Azioni

Questa documentazione è valida AWS CLI solo per la versione 1. Per la documentazione relativa alla versione 2 di AWS CLI, consulta la Guida per l'utente della versione 2.

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 operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Il seguente esempio di codice mostra come utilizzareadd-lf-tags-to-resource.

AWS CLI

Per allegare uno o più tag LF a una risorsa esistente

L'add-lf-tags-to-resourceesempio seguente allega un determinato LF-tag 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 Data Catalog nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarebatch-grant-permissions.

AWS CLI

Per concedere in blocco le autorizzazioni sulle risorse ai responsabili

L'batch-grant-permissionsesempio seguente concede in blocco l'accesso su risorse specifiche ai principali.

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, consulta Concessione e revoca delle autorizzazioni sulle risorse del Data Catalog nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarebatch-revoke-permissions.

AWS CLI

Per revocare in blocco le autorizzazioni sulle risorse ai responsabili

L'batch-revoke-permissionsesempio seguente revoca in blocco l'accesso a risorse specifiche ai principali.

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, consulta Concessione e revoca delle autorizzazioni sulle risorse del Data Catalog nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarecancel-transaction.

AWS CLI

Per annullare una transazione

L'cancel-transactionesempio seguente annulla la transazione.

aws lakeformation cancel-transaction \
    --transaction-id='b014d972ca8347b89825e33c5774aec4'

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Leggere e scrivere nel data lake all'interno delle transazioni nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarecommit-transaction.

AWS CLI

Per effettuare una transazione

L'commit-transactionesempio seguente esegue il commit della transazione.

aws lakeformation commit-transaction \
    --transaction-id='b014d972ca8347b89825e33c5774aec4'

Output:

{
    "TransactionStatus": "committed"
}

Per ulteriori informazioni, consulta Leggere e scrivere nel data lake all'interno delle transazioni nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarecreate-data-cells-filter.

AWS CLI

Esempio 1: per creare un filtro per celle di dati

L'create-data-cells-filteresempio seguente crea un filtro di celle di dati per consentire l'accesso a determinate colonne in base alla condizione 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 Filtraggio dei dati e sicurezza a livello di cella in Lake Formation nella Lake Formation Developer AWS Guide.

Esempio 2: per creare un filtro a colonna

L'create-data-cells-filteresempio 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 Filtraggio dei dati e sicurezza a livello di cella in Lake Formation nella Lake Formation Developer AWS Guide.

Esempio 3: per creare un filtro dati con colonne di esclusione

L'create-data-cells-filteresempio 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 Filtraggio dei dati e sicurezza a livello di cella in Lake Formation nella Lake Formation Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzarecreate-lf-tag.

AWS CLI

Per creare un tag LF

L'create-lf-tagesempio 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 Managing LF-Tags for metadata access control nella AWS Lake Formation Developer Guide.

  • Per API i dettagli, consultate Command CreateLfTagReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaredelete-data-cells-filter.

AWS CLI

Per eliminare il filtro delle celle di dati

L'delete-data-cells-filteresempio seguente elimina un determinato filtro di 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 Filtraggio dei dati e sicurezza a livello di cella in Lake Formation nella Lake Formation Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzaredelete-lf-tag.

AWS CLI

Per eliminare la definizione del tag LF

L'delete-lf-tagesempio 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 Managing LF-Tags for metadata access control nella AWS Lake Formation Developer Guide.

  • Per API i dettagli, consultate Command DeleteLfTagReference AWS CLI .

Il seguente esempio di codice mostra come utilizzaredelete-objects-on-cancel.

AWS CLI

Per eliminare l'oggetto quando la transazione viene annullata

L'delete-objects-on-cancelesempio 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 Leggere e scrivere nel data lake all'interno delle transazioni nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarederegister-resource.

AWS CLI

Per annullare la registrazione di Data Lake Storage

L'deregister-resourceesempio 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 Aggiungere una posizione Amazon S3 al data lake nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzaredescribe-transaction.

AWS CLI

Per recuperare i dettagli di una transazione

L'describe-transactionesempio 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 Leggere e scrivere nel data lake all'interno delle transazioni nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareextend-transaction.

AWS CLI

Per estendere una transazione

L'extend-transactionesempio seguente estende la transazione.

aws lakeformation extend-transaction \
    --transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce'

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta Leggere e scrivere nel data lake all'interno delle transazioni nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareget-data-lake-settings.

AWS CLI

Per recuperare le impostazioni AWS del data lake gestite da Lake Formation

L'get-data-lake-settingsesempio 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 tuo data lake nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareget-effective-permissions-for-path.

AWS CLI

Per recuperare le autorizzazioni sulle risorse situate in un percorso specifico

L'get-effective-permissions-for-pathesempio seguente restituisce i permessi di Lake Formation per una tabella o una risorsa di 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 Managing Lake Formation permissions nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareget-lf-tag.

AWS CLI

Per recuperare la definizione del tag LF

L'get-lf-tagesempio 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 Managing LF-Tags for metadata access control nella AWS Lake Formation Developer Guide.

  • Per API i dettagli, consultate Command GetLfTagReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareget-query-state.

AWS CLI

Per recuperare lo stato di una richiesta inviata

L'get-query-stateesempio 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 Transactional data operations nella AWS Lake Formation Developer Guide.

  • Per API i dettagli, consulta AWS CLI Command GetQueryStateReference.

Il seguente esempio di codice mostra come utilizzareget-query-statistics.

AWS CLI

Per recuperare le statistiche delle interrogazioni

L'get-query-statisticsesempio seguente recupera le statistiche sulla pianificazione e l'esecuzione di un'interrogazione.

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 Transactional data operations nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareget-resource-lf-tags.

AWS CLI

Per elencare i tag LF

L'list-lf-tagsesempio 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 Managing LF-Tags for metadata access control nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareget-table-objects.

AWS CLI

Per elencare gli oggetti della tabella governata

L'get-table-objectsesempio 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 Leggere e scrivere nel data lake all'interno delle transazioni nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareget-work-unit-results.

AWS CLI

Per recuperare le unità di lavoro di una determinata query

L'get-work-unit-resultsesempio 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 Transactional data operations nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareget-work-units.

AWS CLI

Per recuperare le unità di lavoro

L'get-work-unitsesempio 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 Transactional data operations nella AWS Lake Formation Developer Guide.

  • Per API i dettagli, consulta AWS CLI Command GetWorkUnitsReference.

Il seguente esempio di codice mostra come utilizzaregrant-permissions.

AWS CLI

Esempio 1: concedere autorizzazioni al principale sulle risorse utilizzando i tag LF

L'grant-permissionsesempio seguente concede le ALL autorizzazioni al principale su una risorsa di database che corrisponde alla politica LF-Tag.

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, consulta Concessione e revoca delle autorizzazioni sulle risorse del Data Catalog nella AWS Lake Formation Developer Guide.

Esempio 2: concedere autorizzazioni a livello di colonna al principale

L'grant-permissionsesempio seguente concede il permesso di selezionare una colonna specifica al principale.

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, consulta Concessione e revoca delle autorizzazioni sulle risorse del Data Catalog nella AWS Lake Formation Developer Guide.

Esempio 3: concedere i permessi di tabella al principale

L'grant-permissionsesempio seguente concede al principale il permesso di 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, consulta Concessione e revoca delle autorizzazioni sulle risorse del Data Catalog nella AWS Lake Formation Developer Guide.

Esempio 4: concedere le autorizzazioni sui tag LF al principale

L'grant-permissionsesempio seguente concede al principale l'autorizzazione di 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, consulta Concessione e revoca delle autorizzazioni sulle risorse del Data Catalog nella AWS Lake Formation Developer Guide.

Esempio 5: concedere le autorizzazioni sulle posizioni dei dati al responsabile

L'grant-permissionsesempio seguente concede al responsabile l'autorizzazione sulla localizzazione 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, consulta Concessione e revoca delle autorizzazioni sulle risorse del Data Catalog nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarelist-data-cells-filter.

AWS CLI

Per elencare i filtri delle celle di dati

L'list-data-cells-filteresempio 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 Filtraggio dei dati e sicurezza a livello di cella in Lake Formation nella Lake Formation Developer AWS Guide.

Il seguente esempio di codice mostra come utilizzarelist-permissions.

AWS CLI

Esempio 1: per recuperare l'elenco delle autorizzazioni principali sulla risorsa

L'list-permissionsesempio seguente restituisce un elenco delle autorizzazioni principali 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 Managing Lake Formation permissions nella AWS Lake Formation Developer Guide.

Esempio 2: per recuperare l'elenco delle autorizzazioni principali nella tabella con filtri di dati

L'list-permissionsesempio seguente elenca le autorizzazioni sulla tabella con i relativi filtri di dati concessi al principale.

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 Managing Lake Formation permissions nella AWS Lake Formation Developer Guide.

Esempio 3: Per recuperare l'elenco delle autorizzazioni principali sui tag LF

L'list-permissionsesempio seguente elenca le autorizzazioni sui tag LF concesse al principale.

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 Managing Lake Formation permissions nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarelist-resources.

AWS CLI

Per elencare le risorse gestite dalla Lake Formation

L'list-resourcesesempio 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 Managing Lake Formation permissions nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarelist-transactions.

AWS CLI

Per elencare tutti i dettagli delle transazioni

L'list-transactionsesempio 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 Leggere e scrivere nel data lake all'interno delle transazioni nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareput-data-lake-settings.

AWS CLI

Per configurare le impostazioni AWS del data lake gestito da Lake Formation

L'put-data-lake-settingsesempio 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 tuo data lake nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareregister-resource.

AWS CLI

Esempio 1: per registrare lo storage del data lake utilizzando Service Linked Role

L'register-resourceesempio seguente registra la risorsa come gestita da Lake Formation utilizzando il ruolo collegato al servizio.

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 Aggiungere una posizione Amazon S3 al data lake nella AWS Lake Formation Developer Guide.

Esempio 2: per registrare lo storage del data lake utilizzando un ruolo personalizzato

L'register-resourceesempio 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 Aggiungere una posizione Amazon S3 al data lake nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareremove-lf-tags-from-resource.

AWS CLI

Per rimuovere il tag LF da una risorsa

L'remove-lf-tags-from-resourceesempio seguente rimuove l'associazione LF-tag con 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 Data Catalog nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarerevoke-permissions.

AWS CLI

Per revocare le autorizzazioni sulle risorse al principale

L'revoke-permissionsesempio seguente revoca l'accesso principale 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, consulta Concessione e revoca delle autorizzazioni sulle risorse del Data Catalog nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzaresearch-databases-by-lf-tags.

AWS CLI

Per cercare nelle risorse del database per LFTags

L'search-databases-by-lf-tagsesempio seguente cerca le risorse del database che corrispondono all'LFTagespressione.

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 nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzaresearch-tables-by-lf-tags.

AWS CLI

Per cercare nelle risorse della tabella per LFTags

L'search-tables-by-lf-tagsesempio seguente esegue una ricerca sulle risorse della tabella che corrispondono all'LFTagespressione.

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 nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarestart-query-planning.

AWS CLI

Per elaborare l'istruzione di interrogazione

L'start-query-planningesempio seguente invia una richiesta per l'elaborazione di un'istruzione di 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 Leggere e scrivere nel data lake all'interno delle transazioni nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzarestart-transaction.

AWS CLI

Per iniziare una nuova transazione

L'start-transactionesempio seguente avvia una nuova transazione e ne restituisce l'ID.

aws lakeformation start-transaction \
    --transaction-type = 'READ_AND_WRITE'

Output:

{
    "TransactionId": "b014d972ca8347b89825e33c5774aec4"
}

Per ulteriori informazioni, consulta Leggere e scrivere nel data lake all'interno delle transazioni nella AWS Lake Formation Developer Guide.

Il seguente esempio di codice mostra come utilizzareupdate-lf-tag.

AWS CLI

Per aggiornare la definizione del tag LF

L'update-lf-tagesempio 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 Managing LF-Tags for metadata access control nella AWS Lake Formation Developer Guide.

  • Per API i dettagli, consultate Command UpdateLfTagReference AWS CLI .

Il seguente esempio di codice mostra come utilizzareupdate-table-objects.

AWS CLI

Per modificare gli oggetti della tabella governata

L'update-table-objectsesempio 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 Leggere e scrivere nel data lake all'interno delle transazioni nella AWS Lake Formation Developer Guide.