Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de ejemplos de AWS Doc SDK
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.
Temas
Acciones
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-resourcese asocia una etiqueta LF determinada al recurso de tabla.aws lakeformation add-lf-tags-to-resource \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte AddLfTagsToResource
la Referencia de AWS CLI comandos.
-
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-permissionsse concede acceso masivo a recursos específicos a entidades principales.aws lakeformation batch-grant-permissions \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte BatchGrantPermissions
la Referencia de AWS CLI comandos.
-
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-permissionsse revoca acceso masivo a recursos específicos de entidades principales.aws lakeformation batch-revoke-permissions \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte BatchRevokePermissions
la Referencia de AWS CLI comandos.
-
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-transactioncancela 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte CancelTransaction
la Referencia de AWS CLI comandos.
-
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-transactioncancela 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte CommitTransaction
la Referencia de AWS CLI comandos.
-
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-filtercrea 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-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
Ejemplo 2: crear un filtro de columnas
El siguiente ejemplo de
create-data-cells-filtercrea un filtro de datos para conceder acceso a determinadas columnas.aws lakeformation create-data-cells-filter \ --cli-input-jsonfile://input.jsonContenido 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 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-filtercrea un filtro de datos para permitir conceder acceso a todas las columnas salvo las mencionadas.aws lakeformation create-data-cells-filter \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte CreateDataCellsFilter
la Referencia de AWS CLI comandos.
-
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-tagse 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte CreateLfTag
la Referencia de AWS CLI comandos.
-
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-filterse elimina un filtro de celdas de datos específico.aws lakeformation delete-data-cells-filter \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte DeleteDataCellsFilter
la Referencia de AWS CLI comandos.
-
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-tagse 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte DeleteLfTag
la Referencia de AWS CLI comandos.
-
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-cancelelimina el objeto s3 indicado cuando se cancela la transacción.aws lakeformation delete-objects-on-cancel \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte DeleteObjectsOnCancel
la Referencia de AWS CLI comandos.
-
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-resourcese anula el registro del recurso administrado por Lake Formation.aws lakeformation deregister-resource \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte DeregisterResource
la Referencia de AWS CLI comandos.
-
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-transactiondevuelve 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte DescribeTransaction
la Referencia de AWS CLI comandos.
-
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-transactionamplí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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte ExtendTransaction
la Referencia de AWS CLI comandos.
-
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-settingsrecupera la lista de administradores del lago de datos y otros ajustes del lago de datos.aws lakeformation get-data-lake-settings \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte la Referencia GetDataLakeSettings
de AWS CLI comandos.
-
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-pathse 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-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte GetEffectivePermissionsForPath
la Referencia de AWS CLI comandos.
-
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-tagse 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte GetLfTag
la Referencia de AWS CLI comandos.
-
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-statese 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte GetQueryState
la Referencia de AWS CLI comandos.
-
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-statisticsse 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte GetQueryStatistics
la Referencia de AWS CLI comandos.
-
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-tagsse devuelve la lista de etiquetas LF que el solicitante tiene permiso para ver.aws lakeformation list-lf-tags \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte GetResourceLfTags
la Referencia de AWS CLI comandos.
-
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-objectsse devuelve el conjunto de objetos de Amazon S3 que componen la tabla gobernada especificada.aws lakeformation get-table-objects \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte GetTableObjects
la Referencia de AWS CLI comandos.
-
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-resultsse 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='outfileSalida:
outfile with Blob content.Para obtener más información, consulte Transactional data operations en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte GetWorkUnitResults
la Referencia de AWS CLI comandos.
-
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-unitsejemplo 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte GetWorkUnits
la Referencia de AWS CLI comandos.
-
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-permissionsse 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-jsonfile://input.jsonContenido 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 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-permissionsse concede permiso a la entidad principal para seleccionar una columna específica.aws lakeformation grant-permissions \ --cli-input-jsonfile://input.jsonContenido 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 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-permissionsse 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-jsonfile://input.jsonContenido 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 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-permissionsse concede permiso de asociación sobre etiquetas LF a la entidad principal.aws lakeformation grant-permissions \ --cli-input-jsonfile://input.jsonContenido 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 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-permissionsse conceden permisos de ubicación de datos a la entidad principal.aws lakeformation grant-permissions \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte GrantPermissions
la Referencia de AWS CLI comandos.
-
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-filterse muestra un filtro de celdas de datos para una tabla determinada.aws lakeformation list-data-cells-filter \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte ListDataCellsFilter
la Referencia de AWS CLI comandos.
-
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-permissionsse devuelve una lista de permisos de la entidad principal sobre recursos de la base de datos.aws lakeformation list-permissions \ --cli-input-jsonfile://input.jsonContenido 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 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-permissionsse enumeran los permisos de tabla con filtros de datos relacionados concedidos a la entidad principal.aws lakeformation list-permissions \ --cli-input-jsonfile://input.jsonContenido 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 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-permissionsse enumeran los permisos sobre etiquetas LF concedidos a la entidad principal.aws lakeformation list-permissions \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte ListPermissions
la Referencia de AWS CLI comandos.
-
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-resourcesse enumeran los recursos que coinciden con la condición que administra Lake Formation.aws lakeformation list-resources \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte ListResources
la Referencia de AWS CLI comandos.
-
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-transactionsse devuelven metadatos sobre transacciones y su estado.aws lakeformation list-transactions \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte ListTransactions
la Referencia de AWS CLI comandos.
-
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-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte la Referencia PutDataLakeSettings
de AWS CLI comandos.
-
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-resourcese registra el recurso administrado por Lake Formation utilizando un rol vinculado al servicio.aws lakeformation register-resource \ --cli-input-jsonfile://input.jsonContenido 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 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-resourcese registra el recurso administrado por Lake Formation utilizando un rol personalizado.aws lakeformation register-resource \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte RegisterResource
la Referencia de AWS CLI comandos.
-
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-resourcese elimina la asociación de etiqueta LF con el recurso de tabla.aws lakeformation remove-lf-tags-from-resource \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte RemoveLfTagsFromResource
la Referencia de AWS CLI comandos.
-
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-permissionsse revoca el acceso de la entidad principal a una tabla específica de una base de datos determinada.aws lakeformation revoke-permissions \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte RevokePermissions
la Referencia de AWS CLI comandos.
-
En el siguiente ejemplo de código, se muestra cómo utilizar search-databases-by-lf-tags.
- AWS CLI
-
Para buscar en los recursos de la base de datos por LFTags
En el siguiente
search-databases-by-lf-tagsejemplo, se buscan recursos de bases de datos que coincidan con LFTag la expresión.aws lakeformation search-databases-by-lf-tags \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte SearchDatabasesByLfTags
la Referencia de AWS CLI comandos.
-
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-tagsejemplo, se busca en los recursos de la tabla que coincidan con LFTag la expresión.aws lakeformation search-tables-by-lf-tags \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte SearchTablesByLfTags
la Referencia de AWS CLI comandos.
-
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-planningse envía una solicitud para procesar una instrucción de consulta.aws lakeformation start-query-planning \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte StartQueryPlanning
la Referencia de AWS CLI comandos.
-
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-transactionse 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte StartTransaction
la Referencia de AWS CLI comandos.
-
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-tagse 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte UpdateLfTag
la Referencia de AWS CLI comandos.
-
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-objectsse agregan objetos S3 proporcionados a la tabla gobernada especificada.aws lakeformation update-table-objects \ --cli-input-jsonfile://input.jsonContenido 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 en la Guía para desarrolladores de AWS Lake Formation.
-
Para obtener más información sobre la API, consulte UpdateTableObjects
la Referencia de AWS CLI comandos.
-
