Contoh Lake Formation menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Dokumentasi ini AWS CLI hanya untuk Versi 1. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh Lake Formation menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with Lake Formation.

Tindakan adalah kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanadd-lf-tags-to-resource.

AWS CLI

Untuk melampirkan satu atau beberapa LF-tag ke sumber daya yang ada

add-lf-tags-to-resourceContoh berikut melampirkan LF-tag yang diberikan ke sumber daya tabel.

aws lakeformation add-lf-tags-to-resource \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "Resource": {
        "Table": {
            "CatalogId": "123456789111",
            "DatabaseName": "tpc",
            "Name": "dl_tpc_promotion"
        }
    },
    "LFTags": [{
        "CatalogId": "123456789111",
        "TagKey": "usergroup",
        "TagValues": [
            "analyst"
        ]
    }]
}

Output:

{
    "Failures": []
}

Untuk informasi selengkapnya, lihat Menetapkan LF-tag ke sumber daya Katalog Data di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanbatch-grant-permissions.

AWS CLI

Untuk memberikan izin massal pada sumber daya kepada kepala sekolah

batch-grant-permissionsContoh berikut massal memberikan akses pada sumber daya tertentu ke kepala sekolah.

aws lakeformation batch-grant-permissions \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "Entries": [{
            "Id": "1",
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
            },
            "Resource": {
                "Table": {
                    "CatalogId": "123456789111",
                    "DatabaseName": "tpc",
                    "Name": "dl_tpc_promotion"
                }
            },
            "Permissions": [
                "ALL"
            ],
            "PermissionsWithGrantOption": [
                "ALL"
            ]
        },
        {
            "Id": "2",
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
            },
            "Resource": {
                "Table": {
                    "CatalogId": "123456789111",
                    "DatabaseName": "tpc",
                    "Name": "dl_tpc_customer"
                }
            },
            "Permissions": [
                "ALL"
            ],
            "PermissionsWithGrantOption": [
                "ALL"
            ]
        },
        {
            "Id": "3",
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-business-analyst"
            },
            "Resource": {
                "Table": {
                    "CatalogId": "123456789111",
                    "DatabaseName": "tpc",
                    "Name": "dl_tpc_promotion"
                }
            },
            "Permissions": [
                "ALL"
            ],
            "PermissionsWithGrantOption": [
                "ALL"
            ]
        },
        {
            "Id": "4",
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
            },
            "Resource": {
                "DataCellsFilter": {
                    "TableCatalogId": "123456789111",
                    "DatabaseName": "tpc",
                    "TableName": "dl_tpc_item",
                    "Name": "developer_item"
                }
            },
            "Permissions": [
                "SELECT"
            ],
            "PermissionsWithGrantOption": []
        }
    ]
}

Output:

{
    "Failures": []
}

Untuk informasi selengkapnya, lihat Memberikan dan mencabut izin pada sumber daya Katalog Data di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanbatch-revoke-permissions.

AWS CLI

Untuk mencabut izin secara massal pada sumber daya dari prinsipal

batch-revoke-permissionsContoh berikut massal mencabut akses pada sumber daya tertentu dari prinsipal.

aws lakeformation batch-revoke-permissions \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "Entries": [{
            "Id": "1",
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
            },
            "Resource": {
                "Table": {
                    "CatalogId": "123456789111",
                    "DatabaseName": "tpc",
                    "Name": "dl_tpc_promotion"
                }
            },
            "Permissions": [
                "ALL"
            ],
            "PermissionsWithGrantOption": [
                "ALL"
            ]
        },
        {
            "Id": "2",
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-business-analyst"
            },
            "Resource": {
                "Table": {
                    "CatalogId": "123456789111",
                    "DatabaseName": "tpc",
                    "Name": "dl_tpc_promotion"
                }
            },
            "Permissions": [
                "ALL"
            ],
            "PermissionsWithGrantOption": [
                "ALL"
            ]
        }
    ]
}

Output:

{
    "Failures": []
}

Untuk informasi selengkapnya, lihat Memberikan dan mencabut izin pada sumber daya Katalog Data di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakancancel-transaction.

AWS CLI

Untuk membatalkan transaksi

cancel-transactionContoh berikut membatalkan transaksi.

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

Perintah ini tidak menghasilkan output.

Untuk informasi lebih lanjut, lihat Membaca dari dan menulis ke data lake dalam transaksi di AWS Lake Formation Developer Guide.

Contoh kode berikut menunjukkan cara menggunakancommit-transaction.

AWS CLI

Untuk melakukan transaksi

commit-transactionContoh berikut melakukan transaksi.

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

Output:

{
    "TransactionStatus": "committed"
}

Untuk informasi lebih lanjut, lihat Membaca dari dan menulis ke data lake dalam transaksi di AWS Lake Formation Developer Guide.

Contoh kode berikut menunjukkan cara menggunakancreate-data-cells-filter.

AWS CLI

Contoh 1: Untuk membuat filter sel data

create-data-cells-filterContoh berikut membuat filter sel data untuk memungkinkan seseorang memberikan akses ke kolom tertentu berdasarkan kondisi baris.

aws lakeformation create-data-cells-filter \
    --cli-input-json file://input.json

Isi dari 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"
    }
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Pemfilteran data dan keamanan tingkat sel di Lake Formation di Panduan Pengembang AWS Lake Formation.

Contoh 2: Untuk membuat filter kolom

create-data-cells-filterContoh berikut membuat filter data untuk memungkinkan seseorang memberikan akses ke kolom tertentu.

aws lakeformation create-data-cells-filter \
    --cli-input-json file://input.json

Isi dari 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"
    }
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Pemfilteran data dan keamanan tingkat sel di Lake Formation di Panduan Pengembang AWS Lake Formation.

Contoh 3: Untuk membuat filter data dengan kolom kecualikan

create-data-cells-filterContoh berikut membuat filter data untuk memungkinkan seseorang untuk memberikan akses semua kecuali kolom yang disebutkan.

aws lakeformation create-data-cells-filter \
    --cli-input-json file://input.json

Isi dari 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"
    }
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Pemfilteran data dan keamanan tingkat sel di Lake Formation di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakancreate-lf-tag.

AWS CLI

Untuk membuat LF-tag

create-lf-tagContoh berikut membuat LF-tag dengan nama dan nilai yang ditentukan.

aws lakeformation create-lf-tag \
    --catalog-id '123456789111' \
    --tag-key 'usergroup' \
    --tag-values '["developer","analyst","campaign"]'

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengelola LF-tag untuk kontrol akses metadata di Panduan Pengembang AWS Lake Formation.

  • Untuk API detailnya, lihat CreateLfTagdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-data-cells-filter.

AWS CLI

Untuk menghapus filter sel data

delete-data-cells-filterContoh berikut menghapus filter sel data yang diberikan.

aws lakeformation delete-data-cells-filter \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "TableCatalogId": "123456789111",
    "DatabaseName": "tpc",
    "TableName": "dl_tpc_promotion",
    "Name": "developer_promotion"
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Pemfilteran data dan keamanan tingkat sel di Lake Formation di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakandelete-lf-tag.

AWS CLI

Untuk menghapus definisi LF-tag

delete-lf-tagContoh berikut menghapus definisi LF-tag.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengelola LF-tag untuk kontrol akses metadata di Panduan Pengembang AWS Lake Formation.

  • Untuk API detailnya, lihat DeleteLfTagdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-objects-on-cancel.

AWS CLI

Untuk menghapus objek saat transaksi dibatalkan

delete-objects-on-cancelContoh berikut menghapus objek s3 yang terdaftar saat transaksi dibatalkan.

aws lakeformation delete-objects-on-cancel \
    --cli-input-json file://input.json

Isi dari 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"
    }]
}

Perintah ini tidak menghasilkan output.

Untuk informasi lebih lanjut, lihat Membaca dari dan menulis ke data lake dalam transaksi di AWS Lake Formation Developer Guide.

Contoh kode berikut menunjukkan cara menggunakanderegister-resource.

AWS CLI

Untuk membatalkan pendaftaran penyimpanan data lake

deregister-resourceContoh berikut membatalkan pendaftaran sumber daya seperti yang dikelola oleh Lake Formation.

aws lakeformation deregister-resource \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123"
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menambahkan lokasi Amazon S3 ke danau data Anda di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakandescribe-transaction.

AWS CLI

Untuk mengambil detail transaksi

describe-transactionContoh berikut mengembalikan rincian transaksi tunggal.

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

Output:

{
    "TransactionDescription": {
        "TransactionId": "12345972ca8347b89825e33c5774aec4",
        "TransactionStatus": "committed",
        "TransactionStartTime": "2022-08-10T14:29:04.046000+00:00",
        "TransactionEndTime": "2022-08-10T14:29:09.681000+00:00"
    }
}

Untuk informasi lebih lanjut, lihat Membaca dari dan menulis ke data lake dalam transaksi di AWS Lake Formation Developer Guide.

Contoh kode berikut menunjukkan cara menggunakanextend-transaction.

AWS CLI

Untuk memperpanjang transaksi

extend-transactionContoh berikut memperluas transaksi.

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

Perintah ini tidak menghasilkan output.

Untuk informasi lebih lanjut, lihat Membaca dari dan menulis ke data lake dalam transaksi di AWS Lake Formation Developer Guide.

Contoh kode berikut menunjukkan cara menggunakanget-data-lake-settings.

AWS CLI

Untuk mengambil pengaturan AWS danau data yang dikelola Lake Formation

get-data-lake-settingsContoh berikut mengambil daftar administrator data lake dan pengaturan data lake lainnya.

aws lakeformation get-data-lake-settings \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111"
}

Output:

{
    "DataLakeSettings": {
        "DataLakeAdmins": [{
            "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
        }],
        "CreateDatabaseDefaultPermissions": [],
        "CreateTableDefaultPermissions": [
                {
                        "Principal": {
                            "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS"
                        },
                        "Permissions": [
                            "ALL"
                        ]
                }
        ],
        "TrustedResourceOwners": [],
        "AllowExternalDataFiltering": true,
        "ExternalDataFilteringAllowList": [{
            "DataLakePrincipalIdentifier": "123456789111"
        }],
        "AuthorizedSessionTagValueList": [
            "Amazon EMR"
        ]
    }
}

Untuk informasi selengkapnya, lihat Mengubah setelan keamanan default untuk data lake Anda di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanget-effective-permissions-for-path.

AWS CLI

Untuk mengambil izin pada sumber daya yang terletak di jalur tertentu

get-effective-permissions-for-pathContoh berikut mengembalikan izin Lake Formation untuk tabel atau sumber database tertentu yang terletak di jalur di Amazon S3.

aws lakeformation get-effective-permissions-for-path \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111"
}

Output:

{
    "Permissions": [{
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-campaign-manager"
            },
            "Resource": {
                "Database": {
                    "Name": "tpc"
                }
            },
            "Permissions": [
                "DESCRIBE"
            ],
            "PermissionsWithGrantOption": []
        },
        {
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/EMR-RuntimeRole"
            },
            "Resource": {
                "Database": {
                    "Name": "tpc"
                }
            },
            "Permissions": [
                "ALL"
            ],
            "PermissionsWithGrantOption": []
        },
        {
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:saml-provider/oktaSAMLProvider:user/emr-developer"
            },
            "Resource": {
                "Database": {
                    "Name": "tpc"
                }
            },
            "Permissions": [
                "ALL",
                "DESCRIBE"
            ],
            "PermissionsWithGrantOption": []
        },
        {
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
            },
            "Resource": {
                "Database": {
                    "Name": "tpc"
                }
            },
            "Permissions": [
                "ALL",
                "ALTER",
                "CREATE_TABLE",
                "DESCRIBE",
                "DROP"
            ],
            "PermissionsWithGrantOption": [
                "ALL",
                "ALTER",
                "CREATE_TABLE",
                "DESCRIBE",
                "DROP"
            ]
        },
        {
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/LF-GlueServiceRole"
            },
            "Resource": {
                "Database": {
                    "Name": "tpc"
                }
            },
            "Permissions": [
                "CREATE_TABLE"
            ],
            "PermissionsWithGrantOption": []
        }
    ],
    "NextToken": "E5SlJDSTZleUp6SWpvaU9UQTNORE0zTXpFeE5Ua3pJbjE5TENKbGVIQnBjbUYwYVc5dUlqcDdJbk5sWTI5dVpITWlPakUyTm=="
}

Untuk informasi selengkapnya, lihat Mengelola izin Lake Formation di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanget-lf-tag.

AWS CLI

Untuk mengambil definisi LF-tag

get-lf-tagContoh berikut mengambil definisi LF-tag.

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

Output:

{
    "CatalogId": "123456789111",
    "TagKey": "usergroup",
    "TagValues": [
        "analyst",
        "campaign",
        "developer"
    ]
}

Untuk informasi selengkapnya, lihat Mengelola LF-tag untuk kontrol akses metadata di Panduan Pengembang AWS Lake Formation.

  • Untuk API detailnya, lihat GetLfTagdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-query-state.

AWS CLI

Untuk mengambil status kueri yang dikirimkan

get-query-stateContoh berikut mengembalikan keadaan query sebelumnya dikirimkan.

aws lakeformation get-query-state \
    --query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'

Output:

{
    "State": "FINISHED"
}

Untuk informasi selengkapnya, lihat Operasi data transaksional di Panduan Pengembang AWS Lake Formation.

  • Untuk API detailnya, lihat GetQueryStatedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-query-statistics.

AWS CLI

Untuk mengambil statistik kueri

get-query-statisticsContoh berikut mengambil statistik pada perencanaan dan pelaksanaan query.

aws lakeformation get-query-statistics \
    --query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'

Output:

{
    "ExecutionStatistics": {
        "AverageExecutionTimeMillis": 0,
        "DataScannedBytes": 0,
        "WorkUnitsExecutedCount": 0
    },
    "PlanningStatistics": {
        "EstimatedDataToScanBytes": 43235,
        "PlanningTimeMillis": 2377,
        "QueueTimeMillis": 440,
        "WorkUnitsGeneratedCount": 1
    },
    "QuerySubmissionTime": "2022-08-11T02:14:38.641870+00:00"
}

Untuk informasi selengkapnya, lihat Operasi data transaksional di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanget-resource-lf-tags.

AWS CLI

Untuk daftar LF-tag

list-lf-tagsContoh berikut mengembalikan daftar LF-tag yang pemohon memiliki izin untuk melihat.

aws lakeformation list-lf-tags \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "ResourceShareType": "ALL",
    "MaxResults": 2
}

Output:

{
"LFTags": [{
        "CatalogId": "123456789111",
        "TagKey": "category",
        "TagValues": [
            "private",
            "public"
        ]
    },
    {
        "CatalogId": "123456789111",
        "TagKey": "group",
        "TagValues": [
            "analyst",
            "campaign",
            "developer"
        ]
    }],
    "NextToken": "kIiwiZXhwaXJhdGlvbiI6eyJzZWNvbmRzIjoxNjYwMDY4dCI6ZmFsc2V9"
}

Untuk informasi selengkapnya, lihat Mengelola LF-tag untuk kontrol akses metadata di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanget-table-objects.

AWS CLI

Untuk daftar objek dari tabel yang diatur

get-table-objectsContoh berikut mengembalikan kumpulan objek Amazon S3 yang membentuk tabel diatur yang ditentukan.

aws lakeformation get-table-objects \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "012345678901",
    "DatabaseName": "tpc",
    "TableName": "dl_tpc_household_demographics_gov",
    "QueryAsOfTime": "2022-08-10T15:00:00"
}

Output:

{
    "Objects": [{
        "PartitionValues": [],
        "Objects": [{
            "Uri": "s3://lf-data-lake-012345678901/target/dl_tpc_household_demographics_gov/run-unnamed-1-part-block-0-r-00000-snappy-ff26b17504414fe88b302cd795eabd00.parquet",
            "ETag": "12345b1fc50a316b149b4e1f21a73800",
            "Size": 43235
        }]
    }]
}

Untuk informasi lebih lanjut, lihat Membaca dari dan menulis ke data lake dalam transaksi di AWS Lake Formation Developer Guide.

Contoh kode berikut menunjukkan cara menggunakanget-work-unit-results.

AWS CLI

Untuk mengambil unit kerja dari kueri yang diberikan

get-work-unit-resultsContoh berikut mengembalikan unit kerja yang dihasilkan dari query.

aws lakeformation get-work-units \
    --query-id='1234273f-4a62-4cda-8d98-69615ee8be9b' \
    --work-unit-id '0' \
    --work-unit-token 'B2fMSdmQXe9umX8Ux8XCo4=' outfile

Output:

outfile with Blob content.

Untuk informasi selengkapnya, lihat Operasi data transaksional di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanget-work-units.

AWS CLI

Untuk mengambil unit kerja

get-work-unitsContoh berikut mengambil unit kerja yang dihasilkan oleh StartQueryPlanning operasi.

aws lakeformation get-work-units \
    --query-id='1234273f-4a62-4cda-8d98-69615ee8be9b'

Output:

{
    "WorkUnitRanges": [{
        "WorkUnitIdMax": 0,
        "WorkUnitIdMin": 0,
        "WorkUnitToken": "1234eMAk4kLO4umqEL4Z5WuxL04AXwABABVhd3MtY3J5cHRvLXB1YmxpYy1rZXkAREEwYm9QbkhINmFYTWphbmMxZW1PQmEyMGlUb0JFbXNlWmRYc0NmckRIR1dmQ0hjY2YzNFdMcmNXb2JGZmhEK0QvZz09AAEAB2F3cy1rbXMAS2Fybjphd3M6a21zOnVzLWVhc3QtMTo3MDkxNTAyNDkyNDk6a2V5L2VmYmI3NDUyLTY1MjYtNGJiOS1iNmZhLTEzYzJkMTM3MmU2OQC4AQIBAHg6eWNF2ZrQATTAuPDJVCEAQSyIF67vX+f88jzGrYq22gE6jkQlpOB+Oet2eqNUmFudAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQMCOEWRdafowek3RUmAgEQgDsYZZE84nnnbNmvsqCBPLh19nLQ10mUWOg9IfiaOwefEn6L920V0x1LpJACo7MtIBLXnbGcz2dFDZjFygIAAAAADAAAEAAAAAAAAAAAAAAAAAAQSQf8XDSI5pvR4Fx4JsrS/////wAAAAEAAAAAAAAAAAAAAAEAAACX3/w5h75QAPomfKH+cyEKYU1yccUmBl+VSojiGOtdsUk7vcjYXUUboYm3dvqRqX2s4gROMOn+Ij8R0/8jYmnHkpvyAFNVRPyETyIKg7k5Z9+5I1c2d3446Jw/moWGGxjH8AEG9h27ytmOhozxDOEi/F2ZoXz6wlGDfGUo/2WxCkYOhTyNaw6TM+7drTM7yrW4iNVLUM0LX0xnFjIAhLhooWJek6vjQZUAZzBlAjBH8okRtYP8R7AY2Wls/hqFBhG0V4l42AC0LxsuZbMQrE2SzWZUZ0E9Uew7/n0cyX4CMQDR79INyv4ysMByW9kKGGKyba+cCNklExMR+btBQBmMuB2fMSdmQXe9umX8Ux8XCo4="
    }],
    "QueryId": "1234273f-4a62-4cda-8d98-69615ee8be9b"
}

Untuk informasi selengkapnya, lihat Operasi data transaksional di Panduan Pengembang AWS Lake Formation.

  • Untuk API detailnya, lihat GetWorkUnitsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakangrant-permissions.

AWS CLI

Contoh 1: Untuk memberikan izin kepada prinsipal pada sumber daya menggunakan LF-tag

grant-permissionsContoh berikut memberikan ALL izin kepada prinsipal pada sumber daya database yang cocok dengan kebijakan LF-tag.

aws lakeformation grant-permissions \
    --cli-input-json file://input.json

Isi dari 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"
    ]
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Memberikan dan mencabut izin pada sumber daya Katalog Data di Panduan Pengembang AWS Lake Formation.

Contoh 2: Untuk memberikan izin tingkat kolom kepada kepala sekolah

grant-permissionsContoh berikut memberikan izin untuk memilih kolom tertentu untuk kepala sekolah.

aws lakeformation grant-permissions \
    --cli-input-json file://input.json

Isi dari 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": []
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Memberikan dan mencabut izin pada sumber daya Katalog Data di Panduan Pengembang AWS Lake Formation.

Contoh 3: Untuk memberikan izin tabel kepada kepala sekolah

grant-permissionsContoh berikut memberikan izin pilih pada semua tabel database yang diberikan kepada kepala sekolah.

aws lakeformation grant-permissions \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "Principal": {
        "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-developer"
    },
    "Resource": {
        "Table": {
            "CatalogId": "123456789111",
            "DatabaseName": "tpc",
            "TableWildcard": {}
        }
    },
    "Permissions": [
        "SELECT"
    ],
    "PermissionsWithGrantOption": []
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Memberikan dan mencabut izin pada sumber daya Katalog Data di Panduan Pengembang AWS Lake Formation.

Contoh 4: Untuk memberikan izin pada LF-tag kepada kepala sekolah

grant-permissionsContoh berikut memberikan izin asosiasi pada LF-tag kepada kepala sekolah.

aws lakeformation grant-permissions \
    --cli-input-json file://input.json

Isi dari 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": []
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Memberikan dan mencabut izin pada sumber daya Katalog Data di Panduan Pengembang AWS Lake Formation.

Contoh 5: Untuk memberikan izin pada lokasi data kepada kepala sekolah

grant-permissionsContoh berikut memberikan izin pada lokasi data kepada kepala sekolah.

aws lakeformation grant-permissions \
    --cli-input-json file://input.json

Isi dari 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": []
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Memberikan dan mencabut izin pada sumber daya Katalog Data di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanlist-data-cells-filter.

AWS CLI

Untuk membuat daftar filter sel data

list-data-cells-filterContoh berikut daftar filter sel data untuk tabel yang diberikan.

aws lakeformation list-data-cells-filter \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "MaxResults": 2,
    "Table": {
        "CatalogId": "123456789111",
        "DatabaseName": "tpc",
        "Name": "dl_tpc_promotion"
    }
}

Output:

{
    "DataCellsFilters": [{
            "TableCatalogId": "123456789111",
            "DatabaseName": "tpc",
            "TableName": "dl_tpc_promotion",
            "Name": "developer_promotion",
            "RowFilter": {
                "FilterExpression": "p_promo_name='ese'"
            },
            "ColumnNames": [
                "p_channel_details",
                "p_start_date_sk",
                "p_purpose",
                "p_promo_id",
                "p_promo_name",
                "p_end_date_sk",
                "p_discount_active"
            ]
        },
        {
            "TableCatalogId": "123456789111",
            "DatabaseName": "tpc",
            "TableName": "dl_tpc_promotion",
            "Name": "developer_promotion_allrows",
            "RowFilter": {
                "FilterExpression": "TRUE",
                "AllRowsWildcard": {}
            },
            "ColumnNames": [
                "p_channel_details",
                "p_start_date_sk",
                "p_promo_name"
            ]
        }
    ],
    "NextToken": "2MDA2MTgwNiwibmFub3MiOjE0MDAwMDAwMH19"
}

Untuk informasi selengkapnya, lihat Pemfilteran data dan keamanan tingkat sel di Lake Formation di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanlist-permissions.

AWS CLI

Contoh 1: Untuk mengambil daftar izin utama pada sumber daya

list-permissionsContoh berikut mengembalikan daftar izin utama pada sumber daya database.

aws lakeformation list-permissions \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "ResourceType": "DATABASE",
    "MaxResults": 2
}

Output:

{
    "PrincipalResourcePermissions": [{
        "Principal": {
            "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-campaign-manager"
        },
        "Resource": {
            "Database": {
                "CatalogId": "123456789111",
                "Name": "tpc"
            }
        },
        "Permissions": [
            "DESCRIBE"
        ],
        "PermissionsWithGrantOption": []
    }],
    "NextToken": "E5SlJDSTZleUp6SWpvaU9UQTNORE0zTXpFeE5Ua3pJbjE5TENKbGVIQnBjbUYwYVc5dUlqcDdJbk5sWTI5dVpITWlPakUyTm"
}

Untuk informasi selengkapnya, lihat Mengelola izin Lake Formation di Panduan Pengembang AWS Lake Formation.

Contoh 2: Untuk mengambil daftar izin utama pada tabel dengan filter data

list-permissionsContoh berikut mencantumkan izin pada tabel dengan filter data terkait yang diberikan kepada prinsipal.

aws lakeformation list-permissions \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "Resource": {
        "Table": {
            "CatalogId": "123456789111",
            "DatabaseName": "tpc",
            "Name": "dl_tpc_customer"
        }
    },
    "IncludeRelated": "TRUE",
    "MaxResults": 10
}

Output:

{
    "PrincipalResourcePermissions": [{
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/Admin"
            },
            "Resource": {
                "Table": {
                    "CatalogId": "123456789111",
                    "DatabaseName": "customer",
                    "Name": "customer_invoice"
                }
            },
            "Permissions": [
                "ALL",
                "ALTER",
                "DELETE",
                "DESCRIBE",
                "DROP",
                "INSERT"
            ],
            "PermissionsWithGrantOption": [
                "ALL",
                "ALTER",
                "DELETE",
                "DESCRIBE",
                "DROP",
                "INSERT"
            ]
        },
        {
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/Admin"
            },
            "Resource": {
                "TableWithColumns": {
                    "CatalogId": "123456789111",
                    "DatabaseName": "customer",
                    "Name": "customer_invoice",
                    "ColumnWildcard": {}
                }
            },
            "Permissions": [
                "SELECT"
            ],
            "PermissionsWithGrantOption": [
                "SELECT"
            ]
        },
        {
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:role/Admin"
            },
            "Resource": {
                "DataCellsFilter": {
                    "TableCatalogId": "123456789111",
                    "DatabaseName": "customer",
                    "TableName": "customer_invoice",
                    "Name": "dl_us_customer"
                }
            },
            "Permissions": [
                "DESCRIBE",
                "SELECT",
                "DROP"
            ],
            "PermissionsWithGrantOption": []
        }
    ],
    "NextToken": "VyeUFjY291bnRQZXJtaXNzaW9ucyI6ZmFsc2V9"
}

Untuk informasi selengkapnya, lihat Mengelola izin Lake Formation di Panduan Pengembang AWS Lake Formation.

Contoh 3: Untuk mengambil daftar izin utama pada LF-tag

list-permissionsContoh berikut mencantumkan izin pada LF-tag yang diberikan kepada prinsipal.

aws lakeformation list-permissions \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "Resource": {
        "LFTag": {
            "CatalogId": "123456789111",
            "TagKey": "category",
            "TagValues": [
                "private"
            ]
        }
    },
    "MaxResults": 10
}

Output:

{
    "PrincipalResourcePermissions": [{
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
            },
            "Resource": {
                "LFTag": {
                    "CatalogId": "123456789111",
                    "TagKey": "category",
                    "TagValues": [
                        "*"
                    ]
                }
            },
            "Permissions": [
                "DESCRIBE"
            ],
            "PermissionsWithGrantOption": [
                "DESCRIBE"
            ]
        },
        {
            "Principal": {
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
            },
            "Resource": {
                "LFTag": {
                    "CatalogId": "123456789111",
                    "TagKey": "category",
                    "TagValues": [
                        "*"
                    ]
                }
            },
            "Permissions": [
                "ASSOCIATE"
            ],
            "PermissionsWithGrantOption": [
                "ASSOCIATE"
            ]
        }
    ],
    "NextToken": "EJwY21GMGFXOXVJanA3SW5Ocm1pc3Npb25zIjpmYWxzZX0="
}

Untuk informasi selengkapnya, lihat Mengelola izin Lake Formation di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanlist-resources.

AWS CLI

Untuk daftar sumber daya yang dikelola oleh Lake Formation

list-resourcesContoh berikut mencantumkan sumber daya yang cocok dengan kondisi yang dikelola oleh Lake Formation.

aws lakeformation list-resources \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "FilterConditionList": [{
        "Field": "ROLE_ARN",
        "ComparisonOperator": "CONTAINS",
        "StringValueList": [
            "123456789111"
        ]
    }],
    "MaxResults": 10
}

Output:

{
    "ResourceInfoList": [{
            "ResourceArn": "arn:aws:s3:::lf-data-lake-123456789111",
            "RoleArn": "arn:aws:iam::123456789111:role/LF-GlueServiceRole",
            "LastModified": "2022-07-21T02:12:46.669000+00:00"
        },
        {
            "ResourceArn": "arn:aws:s3:::lf-emr-test-123456789111",
            "RoleArn": "arn:aws:iam::123456789111:role/EMRLFS3Role",
            "LastModified": "2022-07-29T16:22:03.211000+00:00"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola izin Lake Formation di Panduan Pengembang AWS Lake Formation.

  • Untuk API detailnya, lihat ListResourcesdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-transactions.

AWS CLI

Untuk mencantumkan semua detail transaksi

list-transactionsContoh berikut mengembalikan metadata tentang transaksi dan statusnya.

aws lakeformation list-transactions \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "StatusFilter": "ALL",
    "MaxResults": 3
}

Output:

{
    "Transactions": [{
            "TransactionId": "1234569f08804cb790d950d4d0fe485e",
            "TransactionStatus": "committed",
            "TransactionStartTime": "2022-08-10T14:32:29.220000+00:00",
            "TransactionEndTime": "2022-08-10T14:32:33.751000+00:00"
        },
        {
            "TransactionId": "12345972ca8347b89825e33c5774aec4",
            "TransactionStatus": "committed",
            "TransactionStartTime": "2022-08-10T14:29:04.046000+00:00",
            "TransactionEndTime": "2022-08-10T14:29:09.681000+00:00"
        },
        {
            "TransactionId": "12345daf6cb047dbba8ad9b0414613b2",
            "TransactionStatus": "committed",
            "TransactionStartTime": "2022-08-10T13:56:51.261000+00:00",
            "TransactionEndTime": "2022-08-10T13:56:51.547000+00:00"
        }
    ],
    "NextToken": "77X1ebypsI7os+X2lhHsZLGNCDK3nNGpwRdFpicSOHgcX1/QMoniUAKcpR3kj3ts3PVdMA=="
}

Untuk informasi lebih lanjut, lihat Membaca dari dan menulis ke data lake dalam transaksi di AWS Lake Formation Developer Guide.

Contoh kode berikut menunjukkan cara menggunakanput-data-lake-settings.

AWS CLI

Untuk mengatur pengaturan AWS danau data yang dikelola Lake Formation

put-data-lake-settingsContoh berikut menetapkan daftar administrator data lake dan pengaturan data lake lainnya.

aws lakeformation put-data-lake-settings \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "DataLakeSettings": {
        "DataLakeAdmins": [{
                "DataLakePrincipalIdentifier": "arn:aws:iam::123456789111:user/lf-admin"
            }
        ],
        "CreateDatabaseDefaultPermissions": [],
        "CreateTableDefaultPermissions": [],
        "TrustedResourceOwners": [],
        "AllowExternalDataFiltering": true,
        "ExternalDataFilteringAllowList": [{
            "DataLakePrincipalIdentifier ": "123456789111"
        }],
        "AuthorizedSessionTagValueList": ["Amazon EMR"]
    }
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengubah setelan keamanan default untuk data lake Anda di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanregister-resource.

AWS CLI

Contoh 1: Untuk mendaftarkan penyimpanan data lake menggunakan Service Linked Role

register-resourceContoh berikut mendaftarkan sumber daya yang dikelola oleh Lake Formation menggunakan peran terkait Layanan.

aws lakeformation register-resource \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
    "UseServiceLinkedRole": true
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menambahkan lokasi Amazon S3 ke danau data Anda di Panduan Pengembang AWS Lake Formation.

Contoh 2: Untuk mendaftarkan penyimpanan data lake menggunakan peran khusus

register-resourceContoh berikut mendaftarkan sumber daya yang dikelola oleh Lake Formation menggunakan peran kustom.

aws lakeformation register-resource \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "ResourceArn": "arn:aws:s3:::lf-emr-athena-result-123",
    "UseServiceLinkedRole": false,
    "RoleArn": "arn:aws:iam::123456789111:role/LF-GlueServiceRole"
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menambahkan lokasi Amazon S3 ke danau data Anda di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanremove-lf-tags-from-resource.

AWS CLI

Untuk menghapus LF-tag dari sumber daya

remove-lf-tags-from-resourceContoh berikut menghapus asosiasi LF-tag dengan sumber daya tabel.

aws lakeformation remove-lf-tags-from-resource \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "CatalogId": "123456789111",
    "Resource": {
        "Table": {
            "CatalogId": "123456789111",
            "DatabaseName": "tpc",
            "Name": "dl_tpc_promotion"
        }
    },
    "LFTags": [{
        "CatalogId": "123456789111",
        "TagKey": "usergroup",
        "TagValues": [
            "developer"
        ]
    }]
}

Output:

{
    "Failures": []
}

Untuk informasi selengkapnya, lihat Menetapkan LF-tag ke sumber daya Katalog Data di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanrevoke-permissions.

AWS CLI

Untuk mencabut izin sumber daya dari prinsipal

revoke-permissionsContoh berikut mencabut akses utama ke tabel tertentu dari database yang diberikan.

aws lakeformation revoke-permissions \
    --cli-input-json file://input.json

Isi dari 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": []
}

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Memberikan dan mencabut izin pada sumber daya Katalog Data di Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakansearch-databases-by-lf-tags.

AWS CLI

Untuk mencari sumber daya database dengan LFTags

search-databases-by-lf-tagsContoh pencarian berikut pada sumber daya database yang cocok LFTag ekspresi.

aws lakeformation search-databases-by-lf-tags \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "MaxResults": 1,
    "CatalogId": "123456789111",
    "Expression": [{
        "TagKey": "usergroup",
        "TagValues": [
            "developer"
        ]
    }]
}

Output:

{
    "DatabaseList": [{
        "Database": {
            "CatalogId": "123456789111",
            "Name": "tpc"
        },
        "LFTags": [{
            "CatalogId": "123456789111",
            "TagKey": "usergroup",
            "TagValues": [
                "developer"
            ]
        }]
    }]
}

Untuk informasi selengkapnya, lihat Melihat sumber daya yang ditetapkan LF-tag dalam Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakansearch-tables-by-lf-tags.

AWS CLI

Untuk mencari sumber daya tabel dengan LFTags

Berikut search-tables-by-lf-tags contoh pencarian pada sumber daya tabel LFTag ekspresi pencocokan.

aws lakeformation search-tables-by-lf-tags \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "MaxResults": 2,
    "CatalogId": "123456789111",
    "Expression": [{
        "TagKey": "usergroup",
        "TagValues": [
            "developer"
        ]
    }]
}

Output:

{
    "NextToken": "c2VhcmNoQWxsVGFnc0luVGFibGVzIjpmYWxzZX0=",
    "TableList": [{
        "Table": {
            "CatalogId": "123456789111",
            "DatabaseName": "tpc",
            "Name": "dl_tpc_item"
        },
        "LFTagOnDatabase": [{
            "CatalogId": "123456789111",
            "TagKey": "usergroup",
            "TagValues": [
                "developer"
            ]
        }],
        "LFTagsOnTable": [{
            "CatalogId": "123456789111",
            "TagKey": "usergroup",
            "TagValues": [
                "developer"
            ]
        }],
        "LFTagsOnColumns": [{
                "Name": "i_item_desc",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_container",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_wholesale_cost",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_manufact_id",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_brand_id",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_formulation",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_current_price",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_size",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_rec_start_date",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_manufact",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_item_sk",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_manager_id",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_item_id",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_class_id",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_class",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_category",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_category_id",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_brand",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_units",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_rec_end_date",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_color",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            },
            {
                "Name": "i_product_name",
                "LFTags": [{
                    "CatalogId": "123456789111",
                    "TagKey": "usergroup",
                    "TagValues": [
                        "developer"
                    ]
                }]
            }
        ]
    }]
}

Untuk informasi selengkapnya, lihat Melihat sumber daya yang ditetapkan LF-tag dalam Panduan Pengembang AWS Lake Formation.

Contoh kode berikut menunjukkan cara menggunakanstart-query-planning.

AWS CLI

Untuk memproses pernyataan kueri

start-query-planningContoh berikut mengirimkan permintaan untuk memproses pernyataan query.

aws lakeformation start-query-planning \
    --cli-input-json file://input.json

Isi dari input.json:

{
    "QueryPlanningContext": {
        "CatalogId": "012345678901",
        "DatabaseName": "tpc"
    },
    "QueryString": "select * from dl_tpc_household_demographics_gov where hd_income_band_sk=9"
}

Output:

{
    "QueryId": "772a273f-4a62-4cda-8d98-69615ee8be9b"
}

Untuk informasi lebih lanjut, lihat Membaca dari dan menulis ke data lake dalam transaksi di AWS Lake Formation Developer Guide.

Contoh kode berikut menunjukkan cara menggunakanstart-transaction.

AWS CLI

Untuk memulai transaksi baru

start-transactionContoh berikut memulai transaksi baru dan mengembalikan ID transaksinya.

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

Output:

{
    "TransactionId": "b014d972ca8347b89825e33c5774aec4"
}

Untuk informasi lebih lanjut, lihat Membaca dari dan menulis ke data lake dalam transaksi di AWS Lake Formation Developer Guide.

Contoh kode berikut menunjukkan cara menggunakanupdate-lf-tag.

AWS CLI

Untuk memperbarui definisi LF-tag

update-lf-tagContoh berikut memperbarui definisi LF-tag.

aws lakeformation update-lf-tag \
    --catalog-id '123456789111' \
    --tag-key 'usergroup' \
    --tag-values-to-add '["admin"]'

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengelola LF-tag untuk kontrol akses metadata di Panduan Pengembang AWS Lake Formation.

  • Untuk API detailnya, lihat UpdateLfTagdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-table-objects.

AWS CLI

Untuk memodifikasi objek dari tabel yang diatur

update-table-objectsContoh berikut menambahkan objek S3 yang disediakan ke tabel diatur yang ditentukan.

aws lakeformation update-table-objects \
    --cli-input-json file://input.json

Isi dari 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
        }
    }]
}

Perintah ini tidak menghasilkan output.

Untuk informasi lebih lanjut, lihat Membaca dari dan menulis ke data lake dalam transaksi di AWS Lake Formation Developer Guide.