Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ejemplos de Lake Formation usando AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface mediante Lake Formation.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `add-lf-tags-to-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `add-lf-tags-to-resource`.
**AWS CLI**
**Para asociar una o más etiquetas LF a un recurso existente**
En el siguiente ejemplo de `add-lf-tags-to-resource` se asocia una etiqueta LF determinada al recurso de tabla.
```
aws lakeformation add-lf-tags-to-resource \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"analyst"
]
}]
}
```
Salida:
```
{
"Failures": []
}
```
Para obtener más información, consulte [Assigning LF-Tags to Data Catalog resources](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-assigning-tags.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [AddLfTagsToResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/add-lf-tags-to-resource.html)la *Referencia de AWS CLI comandos*.
### `batch-grant-permissions`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-grant-permissions`.
**AWS CLI**
**Para conceder permisos masivos sobre recursos a las entidades principales**
En el siguiente ejemplo de `batch-grant-permissions` se concede acceso masivo a recursos específicos a entidades principales.
```
aws lakeformation batch-grant-permissions \
--cli-input-json file://input.json
```
Contenido 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": []
}
]
}
```
Salida:
```
{
"Failures": []
}
```
Para obtener más información, consulte [Granting and revoking permissions on Data Catalog resources](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [BatchGrantPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/batch-grant-permissions.html)la *Referencia de AWS CLI comandos*.
### `batch-revoke-permissions`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-revoke-permissions`.
**AWS CLI**
**Para revocar permisos masivos sobre recursos de las entidades principales**
En el siguiente ejemplo de `batch-revoke-permissions` se revoca acceso masivo a recursos específicos de entidades principales.
```
aws lakeformation batch-revoke-permissions \
--cli-input-json file://input.json
```
Contenido 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"
]
}
]
}
```
Salida:
```
{
"Failures": []
}
```
Para obtener más información, consulte [Granting and revoking permissions on Data Catalog resources](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [BatchRevokePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/batch-revoke-permissions.html)la *Referencia de AWS CLI comandos*.
### `cancel-transaction`
En el siguiente ejemplo de código, se muestra cómo utilizar `cancel-transaction`.
**AWS CLI**
**Para cancelar una transacción**
El siguiente ejemplo de `cancel-transaction` cancela la transacción.
```
aws lakeformation cancel-transaction \
--transaction-id='b014d972ca8347b89825e33c5774aec4'
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Reading from and writing to the data lake within transactions](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [CancelTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/cancel-transaction.html)la *Referencia de AWS CLI comandos*.
### `commit-transaction`
En el siguiente ejemplo de código, se muestra cómo utilizar `commit-transaction`.
**AWS CLI**
**Para confirmar una transacción**
El siguiente ejemplo de `commit-transaction` cancela la transacción.
```
aws lakeformation commit-transaction \
--transaction-id='b014d972ca8347b89825e33c5774aec4'
```
Salida:
```
{
"TransactionStatus": "committed"
}
```
Para obtener más información, consulte [Reading from and writing to the data lake within transactions](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [CommitTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/commit-transaction.html)la *Referencia de AWS CLI comandos*.
### `create-data-cells-filter`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-data-cells-filter`.
**AWS CLI**
**Ejemplo 1: crear un filtro de celdas de datos**
El siguiente ejemplo de `create-data-cells-filter` crea un filtro de celdas de datos para conceder acceso a determinadas columnas en función de la condición de la fila.
```
aws lakeformation create-data-cells-filter \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Data filtering and cell-level security in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) en la *Guía para desarrolladores de AWS Lake Formation*.
**Ejemplo 2: crear un filtro de columnas**
El siguiente ejemplo de `create-data-cells-filter` crea un filtro de datos para conceder acceso a determinadas columnas.
```
aws lakeformation create-data-cells-filter \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Data filtering and cell-level security in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) en la *Guía para desarrolladores de AWS Lake Formation*.
**Ejemplo 3: crear un filtro de datos con columnas excluidas**
El siguiente ejemplo de `create-data-cells-filter` crea un filtro de datos para permitir conceder acceso a todas las columnas salvo las mencionadas.
```
aws lakeformation create-data-cells-filter \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Data filtering and cell-level security in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [CreateDataCellsFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/create-data-cells-filter.html)la *Referencia de AWS CLI comandos*.
### `create-lf-tag`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-lf-tag`.
**AWS CLI**
**Para crear una etiqueta LF**
En el siguiente ejemplo de `create-lf-tag` se crea una etiqueta LF con el nombre y los valores especificados.
```
aws lakeformation create-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup' \
--tag-values '["developer","analyst","campaign"]'
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Managing LF-Tags for metadata access control](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [CreateLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/create-lf-tag.html)la *Referencia de AWS CLI comandos*.
### `delete-data-cells-filter`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-data-cells-filter`.
**AWS CLI**
**Para eliminar un filtro de celdas de datos**
En el siguiente ejemplo de `delete-data-cells-filter` se elimina un filtro de celdas de datos específico.
```
aws lakeformation delete-data-cells-filter \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"TableCatalogId": "123456789111",
"DatabaseName": "tpc",
"TableName": "dl_tpc_promotion",
"Name": "developer_promotion"
}
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Data filtering and cell-level security in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [DeleteDataCellsFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-data-cells-filter.html)la *Referencia de AWS CLI comandos*.
### `delete-lf-tag`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-lf-tag`.
**AWS CLI**
**Para eliminar una definición de etiqueta LF**
En el siguiente ejemplo de `delete-lf-tag` se elimina la definición de etiqueta LF.
```
aws lakeformation delete-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup'
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Managing LF-Tags for metadata access control](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [DeleteLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-lf-tag.html)la *Referencia de AWS CLI comandos*.
### `delete-objects-on-cancel`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-objects-on-cancel`.
**AWS CLI**
**Para eliminar un objeto cuando se cancela la transacción**
El siguiente ejemplo de `delete-objects-on-cancel` elimina el objeto s3 indicado cuando se cancela la transacción.
```
aws lakeformation delete-objects-on-cancel \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Reading from and writing to the data lake within transactions](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [DeleteObjectsOnCancel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/delete-objects-on-cancel.html)la *Referencia de AWS CLI comandos*.
### `deregister-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `deregister-resource`.
**AWS CLI**
**Para anular el registro del almacenamiento de un lago de datos**
En el siguiente ejemplo de `deregister-resource` se anula el registro del recurso administrado por Lake Formation.
```
aws lakeformation deregister-resource \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123"
}
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Adding an Amazon S3 location to your data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [DeregisterResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/deregister-resource.html)la *Referencia de AWS CLI comandos*.
### `describe-transaction`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-transaction`.
**AWS CLI**
**Para recuperar los detalles de una transacción**
El siguiente ejemplo de `describe-transaction` devuelve los detalles de una sola transacción.
```
aws lakeformation describe-transaction \
--transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce'
```
Salida:
```
{
"TransactionDescription": {
"TransactionId": "12345972ca8347b89825e33c5774aec4",
"TransactionStatus": "committed",
"TransactionStartTime": "2022-08-10T14:29:04.046000+00:00",
"TransactionEndTime": "2022-08-10T14:29:09.681000+00:00"
}
}
```
Para obtener más información, consulte [Reading from and writing to the data lake within transactions](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [DescribeTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/describe-transaction.html)la *Referencia de AWS CLI comandos*.
### `extend-transaction`
En el siguiente ejemplo de código, se muestra cómo utilizar `extend-transaction`.
**AWS CLI**
**Para ampliar una transacción**
El siguiente ejemplo de `extend-transaction` amplía la transacción.
```
aws lakeformation extend-transaction \
--transaction-id='8cb4b1a7cc8d486fbaca9a64e7d9f5ce'
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Reading from and writing to the data lake within transactions](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [ExtendTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/extend-transaction.html)la *Referencia de AWS CLI comandos*.
### `get-data-lake-settings`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-data-lake-settings`.
**AWS CLI**
**Para recuperar la configuración de un AWS lago de datos gestionado por Lake Formation**
El siguiente ejemplo de `get-data-lake-settings` recupera la lista de administradores del lago de datos y otros ajustes del lago de datos.
```
aws lakeformation get-data-lake-settings \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"CatalogId": "123456789111"
}
```
Salida:
```
{
"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 obtener más información, consulte [Changing the default security settings for your data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/change-settings.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte la Referencia [GetDataLakeSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-data-lake-settings.html)de *AWS CLI comandos*.
### `get-effective-permissions-for-path`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-effective-permissions-for-path`.
**AWS CLI**
**Para recuperar permisos de recursos ubicados en una ruta específica**
En el siguiente ejemplo de `get-effective-permissions-for-path` se devuelven los permisos de Lake Formation para un recurso de tabla o base de datos especificado ubicado en una ruta de Amazon S3.
```
aws lakeformation get-effective-permissions-for-path \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111"
}
```
Salida:
```
{
"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 obtener más información, consulte [Managing Lake Formation permissions](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [GetEffectivePermissionsForPath](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-effective-permissions-for-path.html)la *Referencia de AWS CLI comandos*.
### `get-lf-tag`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-lf-tag`.
**AWS CLI**
**Para recuperar una definición de etiqueta LF**
En el siguiente ejemplo de `get-lf-tag` se recupera la definición de una etiqueta LF.
```
aws lakeformation get-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup'
```
Salida:
```
{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"analyst",
"campaign",
"developer"
]
}
```
Para obtener más información, consulte [Managing LF-Tags for metadata access control](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [GetLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-lf-tag.html)la *Referencia de AWS CLI comandos*.
### `get-query-state`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-query-state`.
**AWS CLI**
**Para recuperar el estado de una consulta enviada**
En el siguiente ejemplo de `get-query-state` se devuelve el estado de una consulta enviada anteriormente.
```
aws lakeformation get-query-state \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Salida:
```
{
"State": "FINISHED"
}
```
Para obtener más información, consulte [Transactional data operations](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [GetQueryState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-query-state.html)la *Referencia de AWS CLI comandos*.
### `get-query-statistics`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-query-statistics`.
**AWS CLI**
**Para recuperar estadísticas de consultas**
En el siguiente ejemplo de `get-query-statistics` se recuperan las estadísticas sobre la planificación y la ejecución de una consulta.
```
aws lakeformation get-query-statistics \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Salida:
```
{
"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 obtener más información, consulte [Transactional data operations](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [GetQueryStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-query-statistics.html)la *Referencia de AWS CLI comandos*.
### `get-resource-lf-tags`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-resource-lf-tags`.
**AWS CLI**
**Para mostrar etiquetas LF**
En el siguiente ejemplo de `list-lf-tags` se devuelve la lista de etiquetas LF que el solicitante tiene permiso para ver.
```
aws lakeformation list-lf-tags \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceShareType": "ALL",
"MaxResults": 2
}
```
Salida:
```
{
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"private",
"public"
]
},
{
"CatalogId": "123456789111",
"TagKey": "group",
"TagValues": [
"analyst",
"campaign",
"developer"
]
}],
"NextToken": "kIiwiZXhwaXJhdGlvbiI6eyJzZWNvbmRzIjoxNjYwMDY4dCI6ZmFsc2V9"
}
```
Para obtener más información, consulte [Managing LF-Tags for metadata access control](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [GetResourceLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-resource-lf-tags.html)la *Referencia de AWS CLI comandos*.
### `get-table-objects`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-table-objects`.
**AWS CLI**
**Para mostrar objetos de una tabla gobernada**
En el siguiente ejemplo de `get-table-objects` se devuelve el conjunto de objetos de Amazon S3 que componen la tabla gobernada especificada.
```
aws lakeformation get-table-objects \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"CatalogId": "012345678901",
"DatabaseName": "tpc",
"TableName": "dl_tpc_household_demographics_gov",
"QueryAsOfTime": "2022-08-10T15:00:00"
}
```
Salida:
```
{
"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 obtener más información, consulte [Reading from and writing to the data lake within transactions](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [GetTableObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-table-objects.html)la *Referencia de AWS CLI comandos*.
### `get-work-unit-results`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-work-unit-results`.
**AWS CLI**
**Para recuperar unidades de trabajo de una consulta determinada**
En el siguiente ejemplo de `get-work-unit-results` se devuelven las unidades de trabajo resultantes de la consulta.
```
aws lakeformation get-work-units \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b' \
--work-unit-id '0' \
--work-unit-token 'B2fMSdmQXe9umX8Ux8XCo4=' outfile
```
Salida:
```
outfile with Blob content.
```
Para obtener más información, consulte [Transactional data operations](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [GetWorkUnitResults](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-work-unit-results.html)la *Referencia de AWS CLI comandos*.
### `get-work-units`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-work-units`.
**AWS CLI**
**Para recuperar unidades de trabajo**
El siguiente `get-work-units` ejemplo recupera las unidades de trabajo generadas por la StartQueryPlanning operación.
```
aws lakeformation get-work-units \
--query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'
```
Salida:
```
{
"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 obtener más información, consulte [Transactional data operations](https://docs.aws.amazon.com/lake-formation/latest/dg/transactions-data-operations.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [GetWorkUnits](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/get-work-units.html)la *Referencia de AWS CLI comandos*.
### `grant-permissions`
En el siguiente ejemplo de código, se muestra cómo utilizar `grant-permissions`.
**AWS CLI**
**Ejemplo 1: conceder permisos a la entidad principal sobre los recursos mediante etiquetas LF**
En el siguiente ejemplo de `grant-permissions` se conceden TODOS los permisos a la entidad principal en el recurso de base de datos que coincida con la política de etiquetas LF.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Granting and revoking permissions on Data Catalog resources](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
**Ejemplo 2: conceder permisos de nivel de columna a la entidad principal**
En el siguiente ejemplo de `grant-permissions` se concede permiso a la entidad principal para seleccionar una columna específica.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Granting and revoking permissions on Data Catalog resources](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
**Ejemplo 3: conceder permisos de tabla a la entidad principal**
En el siguiente ejemplo de `grant-permissions` se concede a la entidad principal permiso de selección en todas las tablas de una base de datos determinada.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Granting and revoking permissions on Data Catalog resources](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
**Ejemplo 4: conceder permisos sobre etiquetas LF a la entidad principal**
En el siguiente ejemplo de `grant-permissions` se concede permiso de asociación sobre etiquetas LF a la entidad principal.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Granting and revoking permissions on Data Catalog resources](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
**Ejemplo 5: conceder permisos sobre ubicaciones de datos a la entidad principal**
En el siguiente ejemplo de `grant-permissions` se conceden permisos de ubicación de datos a la entidad principal.
```
aws lakeformation grant-permissions \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Granting and revoking permissions on Data Catalog resources](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [GrantPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/grant-permissions.html)la *Referencia de AWS CLI comandos*.
### `list-data-cells-filter`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-data-cells-filter`.
**AWS CLI**
**Para mostrar filtros de celdas de datos**
En el siguiente ejemplo de `list-data-cells-filter` se muestra un filtro de celdas de datos para una tabla determinada.
```
aws lakeformation list-data-cells-filter \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"MaxResults": 2,
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
}
```
Salida:
```
{
"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 obtener más información, consulte [Data filtering and cell-level security in Lake Formation](https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [ListDataCellsFilter](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-data-cells-filter.html)la *Referencia de AWS CLI comandos*.
### `list-permissions`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-permissions`.
**AWS CLI**
**Ejemplo 1: recuperar una lista de permisos de la entidad principal sobre un recurso**
En el siguiente ejemplo de `list-permissions` se devuelve una lista de permisos de la entidad principal sobre recursos de la base de datos.
```
aws lakeformation list-permissions \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"CatalogId": "123456789111",
"ResourceType": "DATABASE",
"MaxResults": 2
}
```
Salida:
```
{
"PrincipalResourcePermissions": [{
"Principal": {
"DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-campaign-manager"
},
"Resource": {
"Database": {
"CatalogId": "123456789111",
"Name": "tpc"
}
},
"Permissions": [
"DESCRIBE"
],
"PermissionsWithGrantOption": []
}],
"NextToken": "E5SlJDSTZleUp6SWpvaU9UQTNORE0zTXpFeE5Ua3pJbjE5TENKbGVIQnBjbUYwYVc5dUlqcDdJbk5sWTI5dVpITWlPakUyTm"
}
```
Para obtener más información, consulte [Managing Lake Formation permissions](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
**Ejemplo 2: recuperar una lista de permisos de la entidad principal sobre la tabla con filtros de datos**
En el siguiente ejemplo de `list-permissions` se enumeran los permisos de tabla con filtros de datos relacionados concedidos a la entidad principal.
```
aws lakeformation list-permissions \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_customer"
}
},
"IncludeRelated": "TRUE",
"MaxResults": 10
}
```
Salida:
```
{
"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 obtener más información, consulte [Managing Lake Formation permissions](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
**Ejemplo 3: recuperar una lista de permisos de la entidad principal sobre las etiquetas LF**
En el siguiente ejemplo de `list-permissions` se enumeran los permisos sobre etiquetas LF concedidos a la entidad principal.
```
aws lakeformation list-permissions \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"LFTag": {
"CatalogId": "123456789111",
"TagKey": "category",
"TagValues": [
"private"
]
}
},
"MaxResults": 10
}
```
Salida:
```
{
"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 obtener más información, consulte [Managing Lake Formation permissions](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [ListPermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-permissions.html)la *Referencia de AWS CLI comandos*.
### `list-resources`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-resources`.
**AWS CLI**
**Para enumerar los recursos administrados por Lake Formation**
En el siguiente ejemplo de `list-resources` se enumeran los recursos que coinciden con la condición que administra Lake Formation.
```
aws lakeformation list-resources \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"FilterConditionList": [{
"Field": "ROLE_ARN",
"ComparisonOperator": "CONTAINS",
"StringValueList": [
"123456789111"
]
}],
"MaxResults": 10
}
```
Salida:
```
{
"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 obtener más información, consulte [Managing Lake Formation permissions](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [ListResources](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-resources.html)la *Referencia de AWS CLI comandos*.
### `list-transactions`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-transactions`.
**AWS CLI**
**Para enumerar todos los detalles de las transacciones**
En el siguiente ejemplo de `list-transactions` se devuelven metadatos sobre transacciones y su estado.
```
aws lakeformation list-transactions \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"CatalogId": "123456789111",
"StatusFilter": "ALL",
"MaxResults": 3
}
```
Salida:
```
{
"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 obtener más información, consulte [Reading from and writing to the data lake within transactions](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [ListTransactions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/list-transactions.html)la *Referencia de AWS CLI comandos*.
### `put-data-lake-settings`
En el siguiente ejemplo de código, se muestra cómo utilizar `put-data-lake-settings`.
**AWS CLI**
**Para establecer la configuración de un AWS lago de datos gestionado por Lake Formation**
En el siguiente ejemplo de `put-data-lake-settings`, se establece la lista de administradores del lago de datos y otros ajustes del lago de datos.
```
aws lakeformation put-data-lake-settings \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Changing the default security settings for your data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/change-settings.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte la Referencia [PutDataLakeSettings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/put-data-lake-settings.html)de *AWS CLI comandos*.
### `register-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `register-resource`.
**AWS CLI**
**Ejemplo 1: registrar almacenamiento de lago de datos mediante un rol vinculado al servicio**
En el siguiente ejemplo de `register-resource` se registra el recurso administrado por Lake Formation utilizando un rol vinculado al servicio.
```
aws lakeformation register-resource \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
"UseServiceLinkedRole": true
}
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Adding an Amazon S3 location to your data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) en la *Guía para desarrolladores de AWS Lake Formation*.
**Ejemplo 2: registrar almacenamiento de lago de datos mediante un rol personalizado**
En el siguiente ejemplo de `register-resource` se registra el recurso administrado por Lake Formation utilizando un rol personalizado.
```
aws lakeformation register-resource \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
"UseServiceLinkedRole": false,
"RoleArn": "arn:aws:iam::123456789111:role/LF-GlueServiceRole"
}
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Adding an Amazon S3 location to your data lake](https://docs.aws.amazon.com/lake-formation/latest/dg/register-data-lake.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [RegisterResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/register-resource.html)la *Referencia de AWS CLI comandos*.
### `remove-lf-tags-from-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `remove-lf-tags-from-resource`.
**AWS CLI**
**Para eliminar una etiqueta LF de un recurso**
En el siguiente ejemplo de `remove-lf-tags-from-resource` se elimina la asociación de etiqueta LF con el recurso de tabla.
```
aws lakeformation remove-lf-tags-from-resource \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"CatalogId": "123456789111",
"Resource": {
"Table": {
"CatalogId": "123456789111",
"DatabaseName": "tpc",
"Name": "dl_tpc_promotion"
}
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Salida:
```
{
"Failures": []
}
```
Para obtener más información, consulte [Assigning LF-Tags to Data Catalog resources](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-assigning-tags.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [RemoveLfTagsFromResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/remove-lf-tags-from-resource.html)la *Referencia de AWS CLI comandos*.
### `revoke-permissions`
En el siguiente ejemplo de código, se muestra cómo utilizar `revoke-permissions`.
**AWS CLI**
**Para revocar permisos sobre recursos de la entidad principal**
En el siguiente ejemplo de `revoke-permissions` se revoca el acceso de la entidad principal a una tabla específica de una base de datos determinada.
```
aws lakeformation revoke-permissions \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Granting and revoking permissions on Data Catalog resources](https://docs.aws.amazon.com/lake-formation/latest/dg/granting-catalog-permissions.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [RevokePermissions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/revoke-permissions.html)la *Referencia de AWS CLI comandos*.
### `search-databases-by-lf-tags`
En el siguiente ejemplo de código, se muestra cómo utilizar `search-databases-by-lf-tags`.
**AWS CLI**
**Para buscar recursos de bases de datos por LFTags**
En el siguiente `search-databases-by-lf-tags` ejemplo, se buscan recursos de bases de datos que coincidan con LFTag la expresión.
```
aws lakeformation search-databases-by-lf-tags \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"MaxResults": 1,
"CatalogId": "123456789111",
"Expression": [{
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Salida:
```
{
"DatabaseList": [{
"Database": {
"CatalogId": "123456789111",
"Name": "tpc"
},
"LFTags": [{
"CatalogId": "123456789111",
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}]
}
```
Para obtener más información, consulte [Viewing the resources that a LF-Tag is assigned to](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-view-tag-resources.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [SearchDatabasesByLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/search-databases-by-lf-tags.html)la *Referencia de AWS CLI comandos*.
### `search-tables-by-lf-tags`
En el siguiente ejemplo de código, se muestra cómo utilizar `search-tables-by-lf-tags`.
**AWS CLI**
**Para buscar recursos en una tabla por LFTags**
En el siguiente `search-tables-by-lf-tags` ejemplo, se busca en los recursos de la tabla que coincidan con LFTag la expresión.
```
aws lakeformation search-tables-by-lf-tags \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"MaxResults": 2,
"CatalogId": "123456789111",
"Expression": [{
"TagKey": "usergroup",
"TagValues": [
"developer"
]
}]
}
```
Salida:
```
{
"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 obtener más información, consulte [Viewing the resources that a LF-Tag is assigned to](https://docs.aws.amazon.com/lake-formation/latest/dg/TBAC-view-tag-resources.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [SearchTablesByLfTags](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/search-tables-by-lf-tags.html)la *Referencia de AWS CLI comandos*.
### `start-query-planning`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-query-planning`.
**AWS CLI**
**Para procesar una instrucción de consulta**
En el siguiente ejemplo de `start-query-planning` se envía una solicitud para procesar una instrucción de consulta.
```
aws lakeformation start-query-planning \
--cli-input-json file://input.json
```
Contenido de `input.json`:
```
{
"QueryPlanningContext": {
"CatalogId": "012345678901",
"DatabaseName": "tpc"
},
"QueryString": "select * from dl_tpc_household_demographics_gov where hd_income_band_sk=9"
}
```
Salida:
```
{
"QueryId": "772a273f-4a62-4cda-8d98-69615ee8be9b"
}
```
Para obtener más información, consulte [Reading from and writing to the data lake within transactions](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [StartQueryPlanning](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/start-query-planning.html)la *Referencia de AWS CLI comandos*.
### `start-transaction`
En el siguiente ejemplo de código, se muestra cómo utilizar `start-transaction`.
**AWS CLI**
**Para iniciar una nueva transacción**
En el siguiente ejemplo de `start-transaction` se inicia una nueva transacción y se devuelve su ID de transacción.
```
aws lakeformation start-transaction \
--transaction-type = 'READ_AND_WRITE'
```
Salida:
```
{
"TransactionId": "b014d972ca8347b89825e33c5774aec4"
}
```
Para obtener más información, consulte [Reading from and writing to the data lake within transactions](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [StartTransaction](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/start-transaction.html)la *Referencia de AWS CLI comandos*.
### `update-lf-tag`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-lf-tag`.
**AWS CLI**
**Para actualizar una definición de etiqueta LF**
En el siguiente ejemplo de `update-lf-tag` se actualiza la definición de etiqueta LF.
```
aws lakeformation update-lf-tag \
--catalog-id '123456789111' \
--tag-key 'usergroup' \
--tag-values-to-add '["admin"]'
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Managing LF-Tags for metadata access control](https://docs.aws.amazon.com/lake-formation/latest/dg/managing-tags.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [UpdateLfTag](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/update-lf-tag.html)la *Referencia de AWS CLI comandos*.
### `update-table-objects`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-table-objects`.
**AWS CLI**
**Para modificar objetos de una tabla gobernada**
En el siguiente ejemplo de `update-table-objects` se agregan objetos S3 proporcionados a la tabla gobernada especificada.
```
aws lakeformation update-table-objects \
--cli-input-json file://input.json
```
Contenido 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 no genera ninguna salida.
Para obtener más información, consulte [Reading from and writing to the data lake within transactions](https://docs.aws.amazon.com/lake-formation/latest/dg/transaction-ops.html) en la *Guía para desarrolladores de AWS Lake Formation*.
+ Para obtener más información sobre la API, consulte [UpdateTableObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/lakeformation/update-table-objects.html)la *Referencia de AWS CLI comandos*.