View a markdown version of this page

Ejemplos de Lake Formation usando AWS CLI - AWS Ejemplos de código de SDK
Acciones

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.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar add-lf-tags-to-resource.

AWS CLI

Para adjuntar uno o más a un recurso existente LF-tags

En el siguiente add-lf-tags-to-resource ejemplo, se adjunta un elemento dado LF-tag al recurso de la 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 Asignación LF-Tags a los recursos del catálogo de datos en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte AddLfTagsToResourcela 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-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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte BatchGrantPermissionsla Referencia de comandos.AWS CLI

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte BatchRevokePermissionsla Referencia de comandos.AWS CLI

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia CancelTransactionde 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-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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia CommitTransactionde 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-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 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 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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia de comandos. CreateDataCellsFilterAWS CLI

En el siguiente ejemplo de código, se muestra cómo utilizar create-lf-tag.

AWS CLI

Para crear LF-Tag

En el siguiente create-lf-tag ejemplo, se crea una LF-Tag 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 Administrar el control de acceso a los metadatos en la Guía LF-Tags para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte CreateLfTagla 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-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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia de comandos. DeleteDataCellsFilterAWS CLI

En el siguiente ejemplo de código, se muestra cómo utilizar delete-lf-tag.

AWS CLI

Para eliminar una definición LF-Tag

En el siguiente delete-lf-tag ejemplo, se elimina la LF-Tag definición.

aws lakeformation delete-lf-tag \
    --catalog-id '123456789111' \
    --tag-key 'usergroup'

Este comando no genera ninguna salida.

Para obtener más información, consulte Administrar el control de acceso a los metadatos en la Guía LF-Tags para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte DeleteLfTagla 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-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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia de comandos. DeleteObjectsOnCancelAWS CLI

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte DeregisterResourcela Referencia de comandos.AWS CLI

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia de DescribeTransactioncomandos AWS CLI .

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia ExtendTransactionde 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 del lago de datos AWS Formation-managed

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte GetDataLakeSettingsla Referencia 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-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 en la Guía para desarrolladores de AWS Lake Formation.

En el siguiente ejemplo de código, se muestra cómo utilizar get-lf-tag.

AWS CLI

Para recuperar la definición LF-tag

En el siguiente get-lf-tag ejemplo, se recupera la LF-tag definición.

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 Administrar el control de acceso a los metadatos en la Guía LF-Tags para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte GetLfTagla 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-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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte GetQueryStatela Referencia de comandos.AWS CLI

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte GetQueryStatisticsla Referencia de comandos.AWS CLI

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte GetTableObjectsla Referencia de comandos.AWS CLI

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia de comandos. GetWorkUnitResultsAWS CLI

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 operación. StartQueryPlanning 

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 GetWorkUnitsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar grant-permissions.

AWS CLI

Ejemplo 1: Para conceder permisos al director sobre los recursos mediante LF-Tags

El siguiente grant-permissions ejemplo concede TODOS los permisos al principal sobre un recurso de base de datos que coincida con la LF-Tag política.

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 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 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 en la Guía para desarrolladores de AWS Lake Formation.

Ejemplo 4: Otorgar permisos LF-Tags al principal

En el siguiente grant-permissions ejemplo, se concede el permiso de asociado LF-Tags al director.

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 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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte GrantPermissionsla 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-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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia de comandos. ListDataCellsFilterAWS CLI

En el siguiente ejemplo de código, se muestra cómo utilizar list-lf-tags.

AWS CLI

Para enumerar LF-tags

El siguiente list-lf-tags ejemplo devuelve una lista de las LF-tags 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 Administrar el control de acceso a los metadatos en la Guía LF-Tags para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte ListLfTagsla 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-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 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 en la Guía para desarrolladores de AWS Lake Formation.

Ejemplo 3: Para recuperar la lista de los permisos principales del LF-Tags

En el siguiente list-permissions ejemplo, se enumeran los permisos LF-Tags otorgados al 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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte ListPermissionsla 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-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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia ListResourcesde 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-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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia ListTransactionsde 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 del lago de datos de Lake AWS Formation-managed

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte PutDataLakeSettingsla Referencia 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-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 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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia de RegisterResourcecomandos AWS CLI .

En el siguiente ejemplo de código, se muestra cómo utilizar remove-lf-tags-from-resource.

AWS CLI

Para eliminar de un recurso LF-Tag

En el siguiente remove-lf-tags-from-resource ejemplo, se elimina la LF-Tag asociación 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 Asignación LF-Tags a los recursos del catálogo de datos en la Guía para desarrolladores de AWS Lake Formation.

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia RevokePermissionsde AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar search-databases-by-lf-tags.

AWS CLI

Para buscar recursos de base de datos por LFTags

En el siguiente ejemplo de search-databases-by-lf-tags se buscan recursos de base de datos que coincidan con la expresión de LFTag.

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 Visualización de los recursos a los que LF-Tag está asignado en la Guía para desarrolladores de AWS Lake Formation.

En el siguiente ejemplo de código, se muestra cómo utilizar search-tables-by-lf-tags.

AWS CLI

Para buscar recursos de tabla por LFTags

En el siguiente ejemplo de search-tables-by-lf-tags se buscan recursos de tabla que coincidan con la expresión de LFTag.

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 Visualización de los recursos a los que LF-Tag está asignado en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte SearchTablesByLfTagsla 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-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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte StartQueryPlanningla Referencia de comandos.AWS CLI

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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte la Referencia StartTransactionde AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar update-lf-tag.

AWS CLI

Para actualizar la definición LF-Tag

En el siguiente update-lf-tag ejemplo se actualiza LF-Tag la definición.

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 Administrar el control de acceso a los metadatos en la Guía LF-Tags para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte UpdateLfTagla 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-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 en la Guía para desarrolladores de AWS Lake Formation.

  • Para obtener más información sobre la API, consulte UpdateTableObjectsla Referencia de comandos.AWS CLI