TAMPILKAN DATABASE - Amazon Redshift
SintaksParameterContoh

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 DATABASES mencantumkan semua database yang dapat diakses, seperti, di dalam gudang data, AWS Glue Data Catalog database (awsdatacatalog), database berbagi data, dan database Lake Formation.

Sintaks

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 daftar database. Menghilangkan parameter ini menunjukkan bahwa Amazon Redshift harus menampilkan database dari akun yang memiliki cluster.

SEPERTI '<expression>'

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

<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 DATABASES, Amazon Redshift akan menggunakan kredenal 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 klaster Amazon Redshift menggunakan identitas federasi dan mengakses tabel dari database eksternal yang dibuat menggunakan perintah. BUAT 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 Amazon Resource Name (ARN) untuk peran IAM yang digunakan klaster Anda untuk autentikasi dan otorisasi. Minimal, peran IAM harus memiliki izin untuk melakukan operasi LIST di 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 untuk datashares dan menggunakan IAM_ROLE, lihat Bekerja dengan jaringan data yang dikelola Lake Formation sebagai konsumen.

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

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

Anda dapat merantai peran sehingga klaster Anda dapat mengambil peran IAM lain, mungkin milik akun lain. Anda dapat merantai hingga 10 peran. Untuk informasi selengkapnya, lihat Merantai peran IAM dalam Amazon Redshift Spectrum.

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

{
    "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 untuk membuat peran IAM yang akan digunakan dengan kueri federasi, lihat. Membuat rahasia dan IAM peran 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>'
BATAS baris_limit

Klausul untuk MEMBATASI jumlah baris yang dikembalikan. Dimana row_limit adalah jumlah maksimum baris yang akan dikembalikan. Row_limit bisa 0—10.000.

Contoh

Contoh berikut menampilkan semua database Data Catalog 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 kredensyal 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