View a markdown version of this page

TAMPILKAN DATABASE - Amazon Redshift
Izin yang diperlukanSintaksParameterContoh

Amazon Redshift tidak akan lagi mendukung penggunaan Python UDF setelah 30 Juni 2026. Kami akan mulai menegakkannya secara bertahap. Untuk informasi lebih lanjut tentang detail opsi akhir masa pakai dan migrasi Python, lihat posting blog yang diterbitkan pada 30 Juni 2025.

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

TAMPILKAN DATABASE

Menampilkan database dari Katalog Data atau gudang data Amazon Redshift. SHOW DATABASE mencantumkan semua database yang dapat diakses, seperti, dalam gudang data, AWS Glue Data Catalog database (awsdatacatalog), database berbagi data, dan database Lake Formation.

Izin yang diperlukan

Semua database dapat dilihat oleh pengguna kecuali:

  • Untuk database yang dibuat dari datashare dengan izin agar terlihat, pengguna saat ini harus diberikan izin USAGE pada database.

Sintaksis

Untuk menampilkan database dari gudang data Amazon Redshift:

SHOW DATABASES 
[ LIKE '<expression>' ]
[ LIMIT row_limit ]

Untuk menampilkan database dari Katalog Data:

SHOW DATABASES FROM DATA CATALOG 
[ ACCOUNT  '<id1>', '<id2>', ... ]
[ LIKE '<expression>' ]
[ IAM_ROLE default | 'SESSION' | 'arn:aws:iam::<account-id>:role/<role-name>' ]
[ LIMIT row_limit ]

Parameter

AKUN '<id1>', '<id2>',...

AWS Glue Data Catalog Akun dari mana untuk membuat daftar database. Menghilangkan parameter ini menunjukkan bahwa Amazon Redshift harus menampilkan database dari akun yang memiliki cluster.

SUKA '<expression>'

Memfilter daftar database ke database yang cocok dengan ekspresi yang Anda tentukan. Parameter ini mendukung pola yang menggunakan karakter wildcard% (persen) dan _ (garis bawah).

<account-id><role-name>IAM_ROLE default | 'SESI' | 'arn:aws:iam: :role/ '

Jika Anda menentukan peran IAM yang terkait dengan cluster saat menjalankan perintah SHOW DATABASE, Amazon Redshift akan menggunakan kredenSIAL peran saat Anda menjalankan kueri pada database.

Menentukan default kata kunci berarti menggunakan peran IAM yang ditetapkan sebagai default dan terkait dengan cluster.

Gunakan 'SESSION' jika Anda terhubung ke cluster Amazon Redshift menggunakan identitas federasi dan mengakses tabel dari database eksternal yang dibuat menggunakan perintahBUAT BASIS DATA. Untuk contoh penggunaan identitas federasi, lihat Menggunakan identitas federasi untuk mengelola akses Amazon Redshift ke sumber daya lokal dan tabel eksternal Amazon Redshift Spectrum, yang menjelaskan cara mengonfigurasi identitas federasi.

Gunakan Nama Sumber Daya Amazon (ARN) untuk peran IAM yang digunakan cluster Anda untuk otentikasi dan otorisasi. Minimal, peran IAM harus memiliki izin untuk melakukan operasi LIST pada bucket Amazon S3 untuk diakses dan operasi GET pada objek Amazon S3 yang berisi bucket. Untuk mempelajari lebih lanjut tentang database yang dibuat dari AWS Glue Data Catalog for datashares dan menggunakan IAM_ROLE, lihat Bek erja dengan berbagi data Lake Formation-managed sebagai konsumen.

Berikut ini menunjukkan sintaks untuk string parameter IAM_ROLE untuk satu ARN.

IAM_ROLE 'arn:aws:iam::<aws-account-id>:role/<role-name>'

Anda dapat mengrantai peran sehingga cluster Anda dapat mengambil peran IAM lain, mungkin milik akun lain. Anda dapat merangkai hingga 10 peran. Untuk informasi selengkapnya, lihat Mengrantai peran IAM di Amazon Redshift Spectrum.

Untuk peran IAM ini, lampirkan kebijakan izin IAM yang serupa dengan berikut ini.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "AccessSecret",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetResourcePolicy",
                "secretsmanager:GetSecretValue",
                "secretsmanager:DescribeSecret",
                "secretsmanager:ListSecretVersionIds"
            ],
            "Resource": "arn:aws:secretsmanager:us-west-2:123456789012:secret:my-rds-secret-VNenFy"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetRandomPassword",
                "secretsmanager:ListSecrets"
            ],
            "Resource": "*"
        }
    ]
}

Untuk langkah-langkah membuat peran IAM untuk digunakan dengan kueri federasi, lihat. Membuat rahasia dan peran IAM untuk menggunakan kueri federasi

catatan

Jangan sertakan spasi dalam daftar peran yang dirantai.

Berikut ini menunjukkan sintaks untuk rantai tiga peran.

IAM_ROLE 'arn:aws:iam::<aws-account-id>:role/<role-1-name>,arn:aws:iam::<aws-account-id>:role/<role-2-name>,arn:aws:iam::<aws-account-id>:role/<role-3-name>'
BATASI batas _baris

Klausa untuk MEMBATASI jumlah baris yang dikembalikan. Di mana row_limit adalah jumlah maksimum baris yang akan dikembalikan. Row_limit bisa 0-10.000.

Contoh

Contoh berikut menampilkan semua database Katalog Data dari ID akun 123456789012.

SHOW DATABASES FROM DATA CATALOG ACCOUNT '123456789012'

  catalog_id  | database_name |                        database_arn                    |     type     |                                             target_database                                      | location | parameters
--------------+---------------+--------------------------------------------------------+--------------+--------------------------------------------------------------------------------------------------+----------+------------
 123456789012 |   database1   | arn:aws:glue:us-east-1:123456789012:database/database1 | Data Catalog |                                                                                                  |          |
 123456789012 |   database2   | arn:aws:glue:us-east-1:123456789012:database/database2 | Data Catalog | arn:aws:redshift:us-east-1:123456789012:datashare:035c45ea-61ce-86f0-8b75-19ac6102c3b7/database2 |          |

Berikut ini adalah contoh yang menunjukkan cara menampilkan semua database Katalog Data dari ID akun 123456789012 saat menggunakan kredenSIAL peran IAM.

SHOW DATABASES FROM DATA CATALOG ACCOUNT '123456789012' IAM_ROLE default;
         
SHOW DATABASES FROM DATA CATALOG ACCOUNT '123456789012' IAM_ROLE <iam-role-arn>;

Contoh berikut menampilkan semua database di gudang data Amazon Redshift yang terhubung.

SHOW DATABASES

database_name  | database_owner | database_type        | database_acl | parameters | database_isolation_level
---------------+----------------+----------------------+--------------+------------+--------------------
awsdatacatalog | 1              | auto mounted catalog | NULL         | UNKNOWN    | UNKNOWN
dev            | 1              | local                | NULL         | NULL       | Snapshot Isolation