Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Exemplos de Lake Formation usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with Lake Formation.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `add-lf-tags-to-resource`
O código de exemplo a seguir mostra como usar `add-lf-tags-to-resource`.
**AWS CLI**
**Para anexar uma ou mais tags LF a um recurso existente**
O exemplo `add-lf-tags-to-resource` a seguir anexa a tag LF fornecida ao recurso da tabela.
```
aws lakeformation add-lf-tags-to-resource \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"analyst"
]
}]
}
```
Saída:
```
{
"Failures": []
}
```
Para obter mais informações, consulte [Atribuir tags LF aos recursos do Data Catalog](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-assigning-tags.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [AddLfTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/add-lf-tags-to-resource.html)em *Referência de AWS CLI Comandos*.
### `batch-grant-permissions`
O código de exemplo a seguir mostra como usar `batch-grant-permissions`.
**AWS CLI**
**Como conceder permissões em massa sobre recursos às entidades principais**
O exemplo `batch-grant-permissions` a seguir concede acesso em massa a recursos específicos para as entidades principais.
```
aws lakeformation batch-grant-permissions \
--cli-input-json file://input.json
```
Conteúdo de `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": []
}
]
}
```
Saída:
```
{
"Failures": []
}
```
Para obter mais informações, consulte [Conceder e revogar permissões em recursos Data Catalog](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [BatchGrantPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/batch-grant-permissions.html)em *Referência de AWS CLI Comandos*.
### `batch-revoke-permissions`
O código de exemplo a seguir mostra como usar `batch-revoke-permissions`.
**AWS CLI**
**Como revogar permissões em massa sobre recursos às entidades principais**
O exemplo `batch-revoke-permissions` a seguir revoga acesso em massa a recursos específicos para as entidades principais.
```
aws lakeformation batch-revoke-permissions \
--cli-input-json file://input.json
```
Conteúdo de `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"
]
}
]
}
```
Saída:
```
{
"Failures": []
}
```
Para obter mais informações, consulte [Conceder e revogar permissões em recursos Data Catalog](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [BatchRevokePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/batch-revoke-permissions.html)em *Referência de AWS CLI Comandos*.
### `cancel-transaction`
O código de exemplo a seguir mostra como usar `cancel-transaction`.
**AWS CLI**
**Como cancelar uma transação**
O exemplo `cancel-transaction` a seguir cancela uma transação.
```
aws lakeformation cancel-transaction \
--transaction-id='b014d972ca8347b89825e33c5774aec4'
```
Este comando não produz saída.
Para obter mais informações, consulte [Ler e gravar no data lake dentro das transações](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [CancelTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/cancel-transaction.html)em *Referência de AWS CLI Comandos*.
### `commit-transaction`
O código de exemplo a seguir mostra como usar `commit-transaction`.
**AWS CLI**
**Como confirmar uma transação**
O exemplo `commit-transaction` a seguir confirma uma transação.
```
aws lakeformation commit-transaction \
--transaction-id='b014d972ca8347b89825e33c5774aec4'
```
Saída:
```
{
"TransactionStatus": "committed"
}
```
Para obter mais informações, consulte [Ler e gravar no data lake dentro das transações](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [CommitTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/commit-transaction.html)em *Referência de AWS CLI Comandos*.
### `create-data-cells-filter`
O código de exemplo a seguir mostra como usar `create-data-cells-filter`.
**AWS CLI**
**Exemplo 1: criar um filtro de células de dados**
O exemplo `create-data-cells-filter` a seguir cria um filtro de célula de dados para permitir que se conceda acesso a determinadas colunas com base na condição da linha.
```
aws lakeformation create-data-cells-filter \
--cli-input-json file://input.json
```
Conteúdo de `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"
}
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Filtrar dados e segurança de células no Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) no *Guia do desenvolvedor do AWS Lake Formation*.
**Exemplo 2: criar um filtro de coluna**
O exemplo `create-data-cells-filter` a seguir cria um filtro de célula de dados para permitir que se conceda acesso a determinadas colunas.
```
aws lakeformation create-data-cells-filter \
--cli-input-json file://input.json
```
Conteúdo de `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"
}
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Filtrar dados e segurança de células no Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) no *Guia do desenvolvedor do AWS Lake Formation*.
**Exemplo 3: criar um filtro de dados com colunas de exclusão**
O exemplo `create-data-cells-filter` a seguir cria um filtro de célula de dados para permitir que se conceda acesso a todas as colunas, exceto as especificadas.
```
aws lakeformation create-data-cells-filter \
--cli-input-json file://input.json
```
Conteúdo de `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"
}
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Filtrar dados e segurança de células no Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [CreateDataCellsFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/create-data-cells-filter.html)em *Referência de AWS CLI Comandos*.
### `create-lf-tag`
O código de exemplo a seguir mostra como usar `create-lf-tag`.
**AWS CLI**
**Para criar uma tag do LF**
O exemplo `create-lf-tag` a seguir cria uma tag do LF com os nomes e valores especificados.
```
aws lakeformation create-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup' \
--tag-values '["developer","analyst","campaign"]'
```
Este comando não produz saída.
Para obter mais informações, consulte [Gerenciar tags LF para controle de acesso a metadados](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [CreateLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/create-lf-tag.html)em *Referência de AWS CLI Comandos*.
### `delete-data-cells-filter`
O código de exemplo a seguir mostra como usar `delete-data-cells-filter`.
**AWS CLI**
**Para excluir o filtro de células de dados**
O exemplo `delete-data-cells-filter` a seguir exclui um determinado filtro de célula de dados.
```
aws lakeformation delete-data-cells-filter \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"TableCatalogId": "123456789111",
"DatabaseName": "tpc",
"TableName": "dl_tpc_promotion",
"Name": "developer_promotion"
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Filtrar dados e segurança de células no Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [DeleteDataCellsFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-data-cells-filter.html)em *Referência de AWS CLI Comandos*.
### `delete-lf-tag`
O código de exemplo a seguir mostra como usar `delete-lf-tag`.
**AWS CLI**
**Para excluir a definição de uma tag LF**
O exemplo `delete-lf-tag` a seguir exclui a definição da tag LF.
```
aws lakeformation delete-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup'
```
Este comando não produz saída.
Para obter mais informações, consulte [Gerenciar tags LF para controle de acesso a metadados](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [DeleteLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-lf-tag.html)em *Referência de AWS CLI Comandos*.
### `delete-objects-on-cancel`
O código de exemplo a seguir mostra como usar `delete-objects-on-cancel`.
**AWS CLI**
**Para excluir o objeto quando a transação é cancelada**
O exemplo `delete-objects-on-cancel` a seguir exclui o objeto s3 listado quando a transação é cancelada.
```
aws lakeformation delete-objects-on-cancel \
--cli-input-json file://input.json
```
Conteúdo de `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"
}]
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Ler e gravar no data lake dentro das transações](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [DeleteObjectsOnCancel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-objects-on-cancel.html)em *Referência de AWS CLI Comandos*.
### `deregister-resource`
O código de exemplo a seguir mostra como usar `deregister-resource`.
**AWS CLI**
**Como cancelar o registro do armazenamento em data lake**
O exemplo `deregister-resource` a seguir cancela o registro do recurso conforme gerenciado pelo Lake Formation.
```
aws lakeformation deregister-resource \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123"
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Adicionar uma localização do Amazon S3 ao seu data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [DeregisterResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/deregister-resource.html)em *Referência de AWS CLI Comandos*.
### `describe-transaction`
O código de exemplo a seguir mostra como usar `describe-transaction`.
**AWS CLI**
**Para recuperar os detalhes de uma transação**
O exemplo `describe-transaction` a seguir retorna os detalhes de uma única transação.
```
aws lakeformation describe-transaction \
--transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce'
```
Saída:
```
{
"TransactionDescription": {
"TransactionId": "12345972ca8347b89825e33c5774aec4",
"TransactionStatus": "committed",
"TransactionStartTime": "2022-08-10T14:29:04.046000+00:00",
"TransactionEndTime": "2022-08-10T14:29:09.681000+00:00"
}
}
```
Para obter mais informações, consulte [Ler e gravar no data lake dentro das transações](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [DescribeTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/describe-transaction.html)em *Referência de AWS CLI Comandos*.
### `extend-transaction`
O código de exemplo a seguir mostra como usar `extend-transaction`.
**AWS CLI**
**Como estender uma transação**
O exemplo `extend-transaction` a seguir estende uma transação.
```
aws lakeformation extend-transaction \
--transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce'
```
Este comando não produz saída.
Para obter mais informações, consulte [Ler e gravar no data lake dentro das transações](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [ExtendTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/extend-transaction.html)em *Referência de AWS CLI Comandos*.
### `get-data-lake-settings`
O código de exemplo a seguir mostra como usar `get-data-lake-settings`.
**AWS CLI**
**Para recuperar as configurações do data AWS lake gerenciado pelo Lake Formation**
O exemplo `get-data-lake-settings` a seguir recupera a lista de administradores de data lake e outras configurações de data lake.
```
aws lakeformation get-data-lake-settings \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "123456789111"
}
```
Saída:
```
{
"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"
]
}
}
```
Para obter mais informações, consulte [Alterando as configurações de segurança padrão do seu data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/change-settings.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [GetDataLakeSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-data-lake-settings.html)em *Referência de AWS CLI Comandos*.
### `get-effective-permissions-for-path`
O código de exemplo a seguir mostra como usar `get-effective-permissions-for-path`.
**AWS CLI**
**Para recuperar permissões em recursos localizados em um caminho específico**
O exemplo `get-effective-permissions-for-path` a seguir retorna as permissões do Lake Formation para uma tabela ou recurso de banco de dados especificado localizado em um caminho no Amazon S3.
```
aws lakeformation get-effective-permissions-for-path \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111"
}
```
Saída:
```
{
"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=="
}
```
Para obter mais informações, consulte [Gerenciar permissões do Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [GetEffectivePermissionsForPath](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-effective-permissions-for-path.html)em *Referência de AWS CLI Comandos*.
### `get-lf-tag`
O código de exemplo a seguir mostra como usar `get-lf-tag`.
**AWS CLI**
**Para recuperar a definição da tag LF**
O exemplo `get-lf-tag` a seguir recupera a definição da tag LF.
```
aws lakeformation get-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup'
```
Saída:
```
{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"analyst",
"campaign",
"developer"
]
}
```
Para obter mais informações, consulte [Gerenciar tags LF para controle de acesso a metadados](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [GetLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-lf-tag.html)em *Referência de AWS CLI Comandos*.
### `get-query-state`
O código de exemplo a seguir mostra como usar `get-query-state`.
**AWS CLI**
**Para recuperar o estado de uma consulta enviada**
O exemplo `get-query-state` a seguir retorna o estado de uma consulta enviada anteriormente.
```
aws lakeformation get-query-state \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Saída:
```
{
"State": "FINISHED"
}
```
Para obter mais informações, consulte [Operações de dados transacionais](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [GetQueryState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-query-state.html)em *Referência de AWS CLI Comandos*.
### `get-query-statistics`
O código de exemplo a seguir mostra como usar `get-query-statistics`.
**AWS CLI**
**Para recuperar estatísticas de consulta**
O exemplo `get-query-statistics` a seguir recupera estatísticas sobre o planejamento e a execução de uma consulta.
```
aws lakeformation get-query-statistics \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Saída:
```
{
"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"
}
```
Para obter mais informações, consulte [Operações de dados transacionais](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [GetQueryStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-query-statistics.html)em *Referência de AWS CLI Comandos*.
### `get-resource-lf-tags`
O código de exemplo a seguir mostra como usar `get-resource-lf-tags`.
**AWS CLI**
**Para listar tags LF**
O exemplo `list-lf-tags` a seguir retorna uma lista de tags LF que o solicitante tem permissão para visualizar.
```
aws lakeformation list-lf-tags \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceShareType": "ALL",
"MaxResults": 2
}
```
Saída:
```
{
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"private",
"public"
]
},
{
"CatalogId": "123456789111",
"TagKey": "group",
"TagValues": [
"analyst",
"campaign",
"developer"
]
}],
"NextToken": "kIiwiZXhwaXJhdGlvbiI6eyJzZWNvbmRzIjoxNjYwMDY4dCI6ZmFsc2V9"
}
```
Para obter mais informações, consulte [Gerenciar tags LF para controle de acesso a metadados](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [GetResourceLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-resource-lf-tags.html)em *Referência de AWS CLI Comandos*.
### `get-table-objects`
O código de exemplo a seguir mostra como usar `get-table-objects`.
**AWS CLI**
**Para listar objetos da tabela controlada**
O exemplo `get-table-objects` a seguir retorna o conjunto de objetos do Amazon S3 que compõem a tabela controlada especificada.
```
aws lakeformation get-table-objects \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "012345678901",
"DatabaseName": "tpc",
"TableName": "dl_tpc_household_demographics_gov",
"QueryAsOfTime": "2022-08-10T15:00:00"
}
```
Saída:
```
{
"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
}]
}]
}
```
Para obter mais informações, consulte [Ler e gravar no data lake dentro das transações](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [GetTableObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-table-objects.html)em *Referência de AWS CLI Comandos*.
### `get-work-unit-results`
O código de exemplo a seguir mostra como usar `get-work-unit-results`.
**AWS CLI**
**Para recuperar unidades de trabalho de uma determinada consulta**
O exemplo `get-work-unit-results` a seguir retorna as unidades de trabalho resultantes da consulta.
```
aws lakeformation get-work-units \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b' \
--work-unit-id '0' \
--work-unit-token 'B2fMSdmQXe9umX8Ux8XCo4=' outfile
```
Saída:
```
outfile with Blob content.
```
Para obter mais informações, consulte [Operações de dados transacionais](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [GetWorkUnitResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-work-unit-results.html)em *Referência de AWS CLI Comandos*.
### `get-work-units`
O código de exemplo a seguir mostra como usar `get-work-units`.
**AWS CLI**
**Para recuperar unidades de trabalho**
O `get-work-units` exemplo a seguir recupera as unidades de trabalho geradas pela StartQueryPlanning operação.
```
aws lakeformation get-work-units \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Saída:
```
{
"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"
}
```
Para obter mais informações, consulte [Operações de dados transacionais](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [GetWorkUnits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-work-units.html)em *Referência de AWS CLI Comandos*.
### `grant-permissions`
O código de exemplo a seguir mostra como usar `grant-permissions`.
**AWS CLI**
**Exemplo 1: conceder permissões à entidade principal sobre recursos usando tags LF**
O exemplo `grant-permissions` a seguir concede TODAS as permissões à entidade principal no recurso de banco de dados que corresponde à política da tag do LF.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Conteúdo de `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"
]
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Conceder e revogar permissões em recursos Data Catalog](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
**Exemplo 2: conceder permissões em nível de coluna à entidade principal**
O exemplo `grant-permissions` a seguir concede à entidade principal permissão para selecionar uma coluna específica.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Conteúdo de `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": []
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Conceder e revogar permissões em recursos Data Catalog](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
**Exemplo 3: conceder permissões de tabela à entidade principal**
O exemplo `grant-permissions` a seguir concede à entidade principal permissão de seleção em todas as tabelas de um determinado banco de dados.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "123456789111",
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
},
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"TableWildcard": {}
}
},
"Permissions": [
"SELECT"
],
"PermissionsWithGrantOption": []
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Conceder e revogar permissões em recursos Data Catalog](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
**Exemplo 4: conceder permissões das tags do LF à entidade principal**
O exemplo `grant-permissions` a seguir concede à entidade principal permissão associada a tags LF.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Conteúdo de `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": []
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Conceder e revogar permissões em recursos Data Catalog](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
**Exemplo 5: conceder permissões de locais de dados à entidade principal**
O exemplo `grant-permissions` a seguir concede à entidade principal permissões de localização de dados.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Conteúdo de `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": []
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Conceder e revogar permissões em recursos Data Catalog](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [GrantPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/grant-permissions.html)em *Referência de AWS CLI Comandos*.
### `list-data-cells-filter`
O código de exemplo a seguir mostra como usar `list-data-cells-filter`.
**AWS CLI**
**Para listar filtros de células de dados**
O exemplo `list-data-cells-filter` a seguir lista os filtros de dados para uma determinada tabela.
```
aws lakeformation list-data-cells-filter \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"MaxResults": 2,
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
}
```
Saída:
```
{
"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"
}
```
Para obter mais informações, consulte [Filtrar dados e segurança de células no Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [ListDataCellsFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-data-cells-filter.html)em *Referência de AWS CLI Comandos*.
### `list-permissions`
O código de exemplo a seguir mostra como usar `list-permissions`.
**AWS CLI**
**Exemplo 1: recuperar a lista das permissões da entidade principal ao recurso**
O exemplo `list-permissions` a seguir retorna uma lista de permissões da entidade principal aos recursos de banco de dados.
```
aws lakeformation list-permissions \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceType": "DATABASE",
"MaxResults": 2
}
```
Saída:
```
{
"PrincipalResourcePermissions": [{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-campaign-manager"
},
"Resource": {
"Database": {
"CatalogId": "123456789111",
"Name": "tpc"
}
},
"Permissions": [
"DESCRIBE"
],
"PermissionsWithGrantOption": []
}],
"NextToken": "E5SlJDSTZleUp6SWpvaU9UQTNORE0zTXpFeE5Ua3pJbjE5TENKbGVIQnBjbUYwYVc5dUlqcDdJbk5sWTI5dVpITWlPakUyTm"
}
```
Para obter mais informações, consulte [Gerenciar permissões do Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
**Exemplo 2: recuperar a lista das permissões da entidade principal à tabela com filtros de dados**
O exemplo `list-permissions` a seguir lista as permissões concedidas à entidade principal sobre a tabela com filtros de dados.
```
aws lakeformation list-permissions \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_customer"
}
},
"IncludeRelated": "TRUE",
"MaxResults": 10
}
```
Saída:
```
{
"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"
}
```
Para obter mais informações, consulte [Gerenciar permissões do Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
**Exemplo 3: recuperar a lista das permissões da entidade principal às tags LF**
O exemplo `list-permissions` a seguir lista as permissões concedidas à entidade principal sobre as tags LF.
```
aws lakeformation list-permissions \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"LFTag": {
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"private"
]
}
},
"MaxResults": 10
}
```
Saída:
```
{
"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="
}
```
Para obter mais informações, consulte [Gerenciar permissões do Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [ListPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-permissions.html)em *Referência de AWS CLI Comandos*.
### `list-resources`
O código de exemplo a seguir mostra como usar `list-resources`.
**AWS CLI**
**Para listar os recursos gerenciados pelo Lake Formation**
O exemplo `list-resources` a seguir lista os recursos que correspondem à condição gerenciada pelo Lake Formation.
```
aws lakeformation list-resources \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"FilterConditionList": [{
"Field": "ROLE_ARN",
"ComparisonOperator": "CONTAINS",
"StringValueList": [
"123456789111"
]
}],
"MaxResults": 10
}
```
Saída:
```
{
"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"
}
]
}
```
Para obter mais informações, consulte [Gerenciar permissões do Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-resources.html)em *Referência de AWS CLI Comandos*.
### `list-transactions`
O código de exemplo a seguir mostra como usar `list-transactions`.
**AWS CLI**
**Para listar todos os detalhes das transações**
O exemplo `list-transactions` a seguir retorna metadados sobre transações e seu status.
```
aws lakeformation list-transactions \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "123456789111",
"StatusFilter": "ALL",
"MaxResults": 3
}
```
Saída:
```
{
"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=="
}
```
Para obter mais informações, consulte [Ler e gravar no data lake dentro das transações](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [ListTransactions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-transactions.html)em *Referência de AWS CLI Comandos*.
### `put-data-lake-settings`
O código de exemplo a seguir mostra como usar `put-data-lake-settings`.
**AWS CLI**
**Para definir as configurações AWS do data lake gerenciado pelo Lake Formation**
O exemplo `put-data-lake-settings` a seguir define a lista de administradores de data lake e outras configurações de data lake.
```
aws lakeformation put-data-lake-settings \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"DataLakeSettings": {
"DataLakeAdmins": [{
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
}
],
"CreateDatabaseDefaultPermissions": [],
"CreateTableDefaultPermissions": [],
"TrustedResourceOwners": [],
"AllowExternalDataFiltering": true,
"ExternalDataFilteringAllowList": [{
"DataLakePrincipalIdentifier ": "123456789111"
}],
"AuthorizedSessionTagValueList": ["Amazon EMR"]
}
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Alterando as configurações de segurança padrão do seu data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/change-settings.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [PutDataLakeSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/put-data-lake-settings.html)em *Referência de AWS CLI Comandos*.
### `register-resource`
O código de exemplo a seguir mostra como usar `register-resource`.
**AWS CLI**
**Exemplo 1: registrar o armazenamento do data lake usando o Service Linked Role**
O exemplo `register-resource` a seguir registra o recurso conforme gerenciado pelo Lake Formation usando o Service Linked Role.
```
aws lakeformation register-resource \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
"UseServiceLinkedRole": true
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Adicionar uma localização do Amazon S3 ao seu data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) no *Guia do desenvolvedor do AWS Lake Formation*.
**Exemplo 2: registrar o armazenamento do data lake usando um perfil personalizado**
O exemplo `register-resource` a seguir registra o recurso conforme gerenciado pelo Lake Formation usando um perfil personalizado.
```
aws lakeformation register-resource \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
"UseServiceLinkedRole": false,
"RoleArn": "arn:aws:iam::123456789111:role/LF-GlueServiceRole"
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Adicionar uma localização do Amazon S3 ao seu data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [RegisterResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/register-resource.html)em *Referência de AWS CLI Comandos*.
### `remove-lf-tags-from-resource`
O código de exemplo a seguir mostra como usar `remove-lf-tags-from-resource`.
**AWS CLI**
**Para remover uma tag do LF de um recurso**
O exemplo `remove-lf-tags-from-resource` a seguir remove a associação da tag do LF ao recurso da tabela.
```
aws lakeformation remove-lf-tags-from-resource \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Saída:
```
{
"Failures": []
}
```
Para obter mais informações, consulte [Atribuir tags LF aos recursos do Data Catalog](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-assigning-tags.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [RemoveLfTagsFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/remove-lf-tags-from-resource.html)em *Referência de AWS CLI Comandos*.
### `revoke-permissions`
O código de exemplo a seguir mostra como usar `revoke-permissions`.
**AWS CLI**
**Como revogar permissões da entidade principal a recursos**
O exemplo `revoke-permissions` a seguir revoga o acesso da entidade principal à tabela específica de um determinado banco de dados.
```
aws lakeformation revoke-permissions \
--cli-input-json file://input.json
```
Conteúdo de `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": []
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Conceder e revogar permissões em recursos Data Catalog](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [RevokePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/revoke-permissions.html)em *Referência de AWS CLI Comandos*.
### `search-databases-by-lf-tags`
O código de exemplo a seguir mostra como usar `search-databases-by-lf-tags`.
**AWS CLI**
**Para pesquisar recursos de banco de dados por LFTags**
O `search-databases-by-lf-tags` exemplo a seguir pesquisa na LFTag expressão correspondente de recursos de banco de dados.
```
aws lakeformation search-databases-by-lf-tags \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"MaxResults": 1,
"CatalogId": "123456789111",
"Expression": [{
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Saída:
```
{
"DatabaseList": [{
"Database": {
"CatalogId": "123456789111",
"Name": "tpc"
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}]
}
```
Para obter mais informações, consulte [Visualizar recursos atribuídos com uma tag do LF](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-view-tag-resources.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [SearchDatabasesByLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/search-databases-by-lf-tags.html)em *Referência de AWS CLI Comandos*.
### `search-tables-by-lf-tags`
O código de exemplo a seguir mostra como usar `search-tables-by-lf-tags`.
**AWS CLI**
**Para pesquisar os recursos da tabela por LFTags**
O `search-tables-by-lf-tags` exemplo a seguir pesquisa na LFTag expressão correspondente de recursos de tabela.
```
aws lakeformation search-tables-by-lf-tags \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"MaxResults": 2,
"CatalogId": "123456789111",
"Expression": [{
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Saída:
```
{
"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"
]
}]
}
]
}]
}
```
Para obter mais informações, consulte [Visualizar recursos atribuídos com uma tag do LF](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-view-tag-resources.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [SearchTablesByLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/search-tables-by-lf-tags.html)em *Referência de AWS CLI Comandos*.
### `start-query-planning`
O código de exemplo a seguir mostra como usar `start-query-planning`.
**AWS CLI**
**Como processar a declaração de consulta**
O exemplo `start-query-planning` a seguir envia uma solicitação para processar uma declaração de consulta.
```
aws lakeformation start-query-planning \
--cli-input-json file://input.json
```
Conteúdo de `input.json`:
```
{
"QueryPlanningContext": {
"CatalogId": "012345678901",
"DatabaseName": "tpc"
},
"QueryString": "select * from dl_tpc_household_demographics_gov where hd_income_band_sk=9"
}
```
Saída:
```
{
"QueryId": "772a273f-4a62-4cda-8d98-69615ee8be9b"
}
```
Para obter mais informações, consulte [Ler e gravar no data lake dentro das transações](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [StartQueryPlanning](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/start-query-planning.html)em *Referência de AWS CLI Comandos*.
### `start-transaction`
O código de exemplo a seguir mostra como usar `start-transaction`.
**AWS CLI**
**Para iniciar uma nova transação**
O exemplo `start-transaction` a seguir inicia uma nova transação e retorna seu ID de transação.
```
aws lakeformation start-transaction \
--transaction-type = 'READ_AND_WRITE'
```
Saída:
```
{
"TransactionId": "b014d972ca8347b89825e33c5774aec4"
}
```
Para obter mais informações, consulte [Ler e gravar no data lake dentro das transações](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [StartTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/start-transaction.html)em *Referência de AWS CLI Comandos*.
### `update-lf-tag`
O código de exemplo a seguir mostra como usar `update-lf-tag`.
**AWS CLI**
**Para atualizar a definição de uma tag LF**
O exemplo `update-lf-tag` a seguir atualiza a definição da tag LF.
```
aws lakeformation update-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup' \
--tag-values-to-add '["admin"]'
```
Este comando não produz saída.
Para obter mais informações, consulte [Gerenciar tags LF para controle de acesso a metadados](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [UpdateLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/update-lf-tag.html)em *Referência de AWS CLI Comandos*.
### `update-table-objects`
O código de exemplo a seguir mostra como usar `update-table-objects`.
**AWS CLI**
**Para modificar objetos da tabela controlada**
O exemplo `update-table-objects` a seguir adiciona objetos S3 fornecidos à tabela controlada especificada.
```
aws lakeformation update-table-objects \
--cli-input-json file://input.json
```
Conteúdo de `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
}
}]
}
```
Este comando não produz saída.
Para obter mais informações, consulte [Ler e gravar no data lake dentro das transações](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) no *Guia do desenvolvedor do AWS Lake Formation*.
+ Para obter detalhes da API, consulte [UpdateTableObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/update-table-objects.html)em *Referência de AWS CLI Comandos*.