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

# API basis data
<a name="aws-glue-api-catalog-databases"></a>

API basis data menjelaskan tipe data basis data, dan termasuk API untuk membuat, menghapus, menemukan, memperbarui, dan mencantumkan basis data.

## Jenis Data
<a name="aws-glue-api-catalog-databases-objects"></a>
+ [Struktur basis data](#aws-glue-api-catalog-databases-Database)
+ [DatabaseInput struktur](#aws-glue-api-catalog-databases-DatabaseInput)
+ [PrincipalPermissions struktur](#aws-glue-api-catalog-databases-PrincipalPermissions)
+ [DataLakePrincipal struktur](#aws-glue-api-catalog-databases-DataLakePrincipal)
+ [DatabaseIdentifier struktur](#aws-glue-api-catalog-databases-DatabaseIdentifier)
+ [FederatedDatabase struktur](#aws-glue-api-catalog-databases-FederatedDatabase)

## Struktur basis data
<a name="aws-glue-api-catalog-databases-Database"></a>

Objek `Database` merupakan pengelompokan logis tabel yang mungkin berada di metastore Hive atau RDBMS.

**Bidang**
+ `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data. Untuk kompatibilitas Hive, nama ini diubah ke huruf kecil ketika disimpan.
+ `Description` — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Deskripsi basis data.
+ `LocationUri` — Pengenal sumber daya seragam (uri), dengan panjang tidak kurang dari 1 atau lebih dari 1024 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Lokasi basis data (misalnya, jalur HDFS).
+ `Parameters` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah String kunci, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 512000 byte.

  Pasangan kunci-nilai ini menentukan parameter dan properti basis data.
+ `CreateTime` — Stempel waktu.

  Waktu ketika metadata basis data dibuat dalam katalog.
+ `CreateTableDefaultPermissions` – Susunan objek [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions).

  Menciptakan satu set izin default pada tabel untuk prinsipal utama. Digunakan oleh AWS Lake Formation. Tidak digunakan dalam AWS Glue operasi normal.
+ `TargetDatabase` — Sebuah objek [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier).

  Struktur `DatabaseIdentifier` yang menggambarkan basis data target untuk penautan sumber daya.
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data tempat basis data berada.
+ `FederatedDatabase` — Sebuah objek [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase).

  `FederatedDatabase`Struktur yang mereferensikan entitas di luar AWS Glue Data Catalog.

## DatabaseInput struktur
<a name="aws-glue-api-catalog-databases-DatabaseInput"></a>

Struktur yang digunakan untuk membuat atau memperbarui basis data.

**Bidang**
+ `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data. Untuk kompatibilitas Hive, nama ini diubah ke huruf kecil ketika disimpan.
+ `Description` — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Deskripsi basis data.
+ `LocationUri` — Pengenal sumber daya seragam (uri), dengan panjang tidak kurang dari 1 atau lebih dari 1024 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Lokasi basis data (misalnya, jalur HDFS). 
+ `Parameters` – Susunan peta pasangan nilai kunci.

  Masing-masing kunci adalah sebuah String kunci, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 512000 byte.

  Pasangan kunci-nilai ini menentukan parameter dan properti basis data.

  Pasangan kunci-nilai ini menentukan parameter dan properti basis data.
+ `CreateTableDefaultPermissions` – Susunan objek [PrincipalPermissions](#aws-glue-api-catalog-databases-PrincipalPermissions).

  Menciptakan satu set izin default pada tabel untuk prinsipal utama. Digunakan oleh AWS Lake Formation. Tidak digunakan dalam AWS Glue operasi normal.
+ `TargetDatabase` — Sebuah objek [DatabaseIdentifier](#aws-glue-api-catalog-databases-DatabaseIdentifier).

  Struktur `DatabaseIdentifier` yang menggambarkan basis data target untuk penautan sumber daya.
+ `FederatedDatabase` — Sebuah objek [FederatedDatabase](#aws-glue-api-catalog-databases-FederatedDatabase).

  `FederatedDatabase`Struktur yang mereferensikan entitas di luar AWS Glue Data Catalog.

## PrincipalPermissions struktur
<a name="aws-glue-api-catalog-databases-PrincipalPermissions"></a>

Izin yang diberikan ke sebuah prinsipal utama.

**Bidang**
+ `Principal` — Sebuah objek [DataLakePrincipal](#aws-glue-api-catalog-databases-DataLakePrincipal).

  Prinsipal utama yang diberikan izin.
+ `Permissions` – Susunan string UTF-8.

  Izin yang diberikan kepada prinsipal utama.

## DataLakePrincipal struktur
<a name="aws-glue-api-catalog-databases-DataLakePrincipal"></a>

Kepala AWS Lake Formation sekolah.

**Bidang**
+ `DataLakePrincipalIdentifier` — String UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 255 byte.

  Pengenal untuk AWS Lake Formation kepala sekolah.

## DatabaseIdentifier struktur
<a name="aws-glue-api-catalog-databases-DatabaseIdentifier"></a>

Struktur yang menggambarkan database target untuk menghubungkan sumber daya.

**Bidang**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data tempat basis data berada.
+ `DatabaseName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data katalog.
+ `Region` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Wilayah basis data target.

## FederatedDatabase struktur
<a name="aws-glue-api-catalog-databases-FederatedDatabase"></a>

Database yang menunjuk ke entitas di luar AWS Glue Data Catalog.

**Bidang**
+ `Identifier` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 512 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Pengidentifikasi unik untuk database federasi.
+ `ConnectionName` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama koneksi ke metastore eksternal.
+ `ConnectionType` — String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Jenis koneksi yang digunakan untuk mengakses database federasi, seperti JDBC, ODBC, atau protokol koneksi lain yang didukung.

## Operasi
<a name="aws-glue-api-catalog-databases-actions"></a>
+ [CreateDatabase tindakan (Python: create\$1database)](#aws-glue-api-catalog-databases-CreateDatabase)
+ [UpdateDatabase tindakan (Python: update\$1database)](#aws-glue-api-catalog-databases-UpdateDatabase)
+ [DeleteDatabase tindakan (Python: delete\$1database)](#aws-glue-api-catalog-databases-DeleteDatabase)
+ [GetDatabase tindakan (Python: get\$1database)](#aws-glue-api-catalog-databases-GetDatabase)
+ [GetDatabases tindakan (Python: get\$1databases)](#aws-glue-api-catalog-databases-GetDatabases)

## CreateDatabase tindakan (Python: create\$1database)
<a name="aws-glue-api-catalog-databases-CreateDatabase"></a>

Menciptakan sebuah basis data baru dalam Katalog Data.

**Permintaan**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID Katalog Data tempat basis data akan dibuat. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `DatabaseInput` — *Wajib:* Sebuah objek [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput).

  Metadata untuk basis data.
+ `Tags` — Sebuah rangkaian peta pasangan nilai kunci, tidak lebih dari 50 pasang.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak kurang dari 1 atau lebih dari 128 byte.

  Masing-masing kunci adalah sebuah string UTF-8, dengan panjang tidak lebih dari 256 byte.

  Tag yang Anda tetapkan ke database.

**Respons**
+ *Tidak ada parameter Respons.*

**Kesalahan**
+ `InvalidInputException`
+ `AlreadyExistsException`
+ `ResourceNumberLimitExceededException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `FederatedResourceAlreadyExistsException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## UpdateDatabase tindakan (Python: update\$1database)
<a name="aws-glue-api-catalog-databases-UpdateDatabase"></a>

Memperbarui definisi basis data yang ada dalam Katalog Data.

**Permintaan**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data tempat metadata basis data berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data yang akan diperbarui dalam katalog. Untuk kompatibilitas Hive, nama ini diubah ke huruf kecil.
+ `DatabaseInput` — *Wajib:* Sebuah objek [DatabaseInput](#aws-glue-api-catalog-databases-DatabaseInput).

  Sebuah objek `DatabaseInput` menentukan definisi baru dari metadata basis data dalam katalog.

**Respons**
+ *Tidak ada parameter Respons.*

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `ConcurrentModificationException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`
+ `AlreadyExistsException`

## DeleteDatabase tindakan (Python: delete\$1database)
<a name="aws-glue-api-catalog-databases-DeleteDatabase"></a>

Menghapus sebuah basis data yang ditentukan dari Katalog Data.

**catatan**  
Setelah menyelesaikan operasi ini, Anda tidak lagi memiliki akses ke tabel (dan semua versi tabel dan partisi yang mungkin milik tabel) dan fungsi yang ditentukan pengguna dalam database yang dihapus. AWS Glue menghapus sumber daya “yatim piatu” ini secara asinkron pada waktu yang tepat, atas kebijaksanaan layanan.  
Untuk memastikan penghapusan langsung dari semua sumber daya terkait, sebelum memanggil `DeleteDatabase`, gunakan `DeleteTableVersion` atau `BatchDeleteTableVersion`, `DeletePartition` atau `BatchDeletePartition`, `DeleteUserDefinedFunction`, dan `DeleteTable` atau `BatchDeleteTable`, untuk menghapus sumber daya yang dimiliki oleh basis data.

**Permintaan**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data tempat basis data berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data yang akan dihapus. Untuk kompatibilitas Hive, ini semua harus huruf kecil.

**Respons**
+ *Tidak ada parameter Respons.*

**Kesalahan**
+ `EntityNotFoundException`
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `ConcurrentModificationException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetDatabase tindakan (Python: get\$1database)
<a name="aws-glue-api-catalog-databases-GetDatabase"></a>

Mengambil definisi dari basis data yang ditentukan.

**Permintaan**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data tempat basis data berada. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `Name` — *Wajib:* String UTF-8, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama basis data yang akan diambil. Untuk kompatibilitas Hive, nama ini harus huruf kecil.

**Respons**
+ `Database` — Sebuah objek [Basis Data](#aws-glue-api-catalog-databases-Database).

  Definisi basis data yang ditentukan dalam Katalog Data.

**Kesalahan**
+ `InvalidInputException`
+ `EntityNotFoundException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`

## GetDatabases tindakan (Python: get\$1databases)
<a name="aws-glue-api-catalog-databases-GetDatabases"></a>

Mengambil semua basis data yang didefinisikan dalam Katalog Data yang ditentukan.

**Permintaan**
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data tempat `Databases` akan diambil. Jika tidak ada yang disediakan, ID AWS akun digunakan secara default.
+ `NextToken` – String UTF-8.

  Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 100.

  Jumlah maksimum basis data yang akan dikembalikan dalam satu respons.
+ `ResourceShareType` – String UTF-8 (nilai yang valid: `FOREIGN` \$1 `ALL` \$1 `FEDERATED`).

  Memungkinkan Anda untuk menentukan apakah Anda ingin mencantumkan basis data yang dibagikan dengan akun Anda. Nilai yang diijinkan adalah`FEDERATED`, `FOREIGN` atau`ALL`. 
  + Jika disetel ke`FEDERATED`, akan mencantumkan database federasi (merujuk entitas eksternal) yang dibagikan dengan akun Anda.
  + Jika diatur ke `FOREIGN`, akan mencantumkan basis data yang dibagikan dengan akun Anda. 
  + Jika diatur ke `ALL`, akan mencantumkan basis data yang dibagikan dengan akun Anda, serta basis data di akun lokal Anda. 
+ `AttributesToGet` – Susunan string UTF-8.

  Menentukan bidang database yang dikembalikan oleh `GetDatabases` panggilan. Parameter ini tidak menerima daftar kosong. Permintaan harus mencakup`NAME`.

**Respons**
+ `DatabaseList` – *Wajib:* Susunan objek [Basis Data](#aws-glue-api-catalog-databases-Database).

  Daftar objek `Database` dari katalog yang ditentukan.
+ `NextToken` – String UTF-8.

  Sebuah token kelanjutan untuk pemberian nomor halaman untuk daftar token yang ditampilkan, dikembalikan jika segmen saat ini dari daftar tersebut bukan yang terakhir.

**Kesalahan**
+ `InvalidInputException`
+ `InternalServiceException`
+ `OperationTimeoutException`
+ `GlueEncryptionException`
+ `EntityNotFoundException`
+ `FederationSourceException`
+ `FederationSourceRetryableException`