Amazon Redshift tidak akan lagi mendukung pembuatan Python UDFs baru mulai Patch 198. Python yang ada UDFs akan terus berfungsi hingga 30 Juni 2026. Untuk informasi lebih lanjut, lihat posting blog.

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

Connect ke Redshift dengan sesi peran IAM yang disempurnakan Identitas

Anda dapat menggunakan Pusat Identitas IAM untuk menyediakan akses gabungan ke klaster Amazon Redshift dan grup kerja tanpa server. Pendekatan ini memungkinkan pengguna untuk mengautentikasi menggunakan kredensil Pusat Identitas mereka.

Amazon Redshift menyediakan operasi GetIdentityCenterAuthToken API untuk menghasilkan token resmi yang berisi informasi identitas pengguna. Ini APIs tersedia untuk cluster yang disediakan dan grup kerja tanpa server. Token memungkinkan akses masuk tunggal yang mulus ke database Amazon Redshift menggunakan penyiapan Pusat Identitas yang ada.

Prasyarat

Sebelum menggunakan otentikasi Pusat Identitas dengan Amazon Redshift, pastikan Anda memiliki yang berikut:

Cara kerja otentikasi Pusat Identitas

Autentikasi Pusat Identitas untuk Amazon Redshift menggunakan alur kerja berikut:

GetIdentityCenterAuthToken Operasi API

Amazon Redshift menyediakan dua operasi GetIdentityCenterAuthToken API terpisah: satu untuk cluster yang disediakan dan satu untuk grup kerja tanpa server. Kedua operasi memiliki nama yang sama tetapi menerima parameter yang berbeda tergantung pada jenis sumber daya target.

GetIdentityCenterAuthToken untuk cluster yang disediakan

Untuk klaster Amazon Redshift yang disediakan, gunakan API GetIdentityCenterAuthToken di layanan Amazon Redshift untuk menghasilkan token resmi.

Sintaksis Permintaan

{
   "ClusterIds": [ "string" ]
}
                

Permintaan parameter

Contoh-contoh CLI

Contoh: Dapatkan token resmi untuk satu cluster

aws redshift get-identity-center-auth-token \
    --cluster-ids my-redshift-cluster

Contoh: Dapatkan token resmi untuk beberapa cluster

aws redshift get-identity-center-auth-token \
    --cluster-ids my-cluster-1 my-cluster-2

GetIdentityCenterAuthToken untuk kelompok kerja tanpa server

Untuk workgroup Amazon Redshift Tanpa Server, gunakan API di GetIdentityCenterAuthToken layanan Amazon Redshift Serverless untuk menghasilkan token resmi.

Sintaksis Permintaan

{
   "WorkgroupNames": [ "string" ]
}
                

Permintaan parameter

Contoh-contoh CLI

Contoh: Dapatkan token resmi untuk satu grup kerja

aws redshift-serverless get-identity-center-auth-token \
    --workgroup-names my-workgroup

Contoh: Dapatkan token resmi untuk beberapa grup kerja

aws redshift-serverless get-identity-center-auth-token \
    --workgroup-names workgroup-1 workgroup-2

Sintaksis Respons

Keduanya APIs mengembalikan struktur respons yang sama:

{
   "AuthorizedToken": "string",
   "ExpirationTime": "timestamp"
}
            

Parameter respons

Contoh tanggapan

{
    "AuthorizedToken": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyQGV4YW1wbGUuY29tIiwiaWF0IjoxNjQwOTk1MjAwLCJleHAiOjE2NDA5OTg4MDAsImNsdXN0ZXJzIjpbIm15LWNsdXN0ZXIiXX0...",
    "ExpirationTime": "2024-01-01T12:00:00Z"
}

Integrasi driver

Driver Amazon Redshift mendukung otentikasi Pusat Identitas melalui penggunaan token langsung:

Penggunaan token langsung

Setelah memanggil GetIdentityCenterAuthToken API untuk mendapatkan token, gunakan IdpTokenAuthPlugin dengan jenis SUBJECT_TOKEN token.

Konfigurasi Koneksi:

plugin_name = com.amazon.redshift.plugin.IdpTokenAuthPlugin
token_type = SUBJECT_TOKEN
token = {encrypted_token_from_api_response}
            

Untuk informasi mendetail tentang plugin autentikasi Pusat Identitas dan konfigurasi driver, lihat Menyambung ke klaster Amazon Redshift.

Contoh kode Java

Contoh kode Java untuk terhubung menggunakan otentikasi Pusat Identitas:

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
import java.util.Properties;

// Get token from GetIdentityCenterAuthToken API
String token = "your_encrypted_token_from_api_response";

// Configure connection properties
Properties props = new Properties();
props.setProperty("user", "your_username");
props.setProperty("plugin_name", "com.amazon.redshift.plugin.IdpTokenAuthPlugin");
props.setProperty("token_type", "SUBJECT_TOKEN");
props.setProperty("token", token);

// Connect to Redshift
String url = "jdbc:redshift://your-cluster.region.redshift.amazonaws.com:5439/your_database";
try (Connection conn = DriverManager.getConnection(url, props)) {
    // Use connection
    System.out.println("Connected successfully!");
} catch (SQLException e) {
    e.printStackTrace();
}
            

Persyaratan kebijakan IAM

Untuk menggunakan autentikasi Pusat Identitas dengan Amazon Redshift, izin IAM tertentu diperlukan di luar izin standar yang diperlukan untuk menghubungkan ke kluster dan grup kerja Amazon Redshift.

Izin API:

Untuk klaster yang disediakan, sesi peran IAM Anda yang disempurnakan harus memiliki:

Untuk grup kerja tanpa server, sesi peran IAM Anda yang disempurnakan harus memiliki:

Contoh kebijakan IAM

Contoh kebijakan untuk klaster yang disediakan:

{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "redshift:GetIdentityCenterAuthToken"
            ],
            "Resource": [
                "arn:aws:redshift:us-east-1:123456789012:cluster:my-cluster"
            ]
        }
    ]
}

Contoh kebijakan untuk grup kerja tanpa server:

{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "redshift-serverless:GetIdentityCenterAuthToken"
            ],
            "Resource": [
                "arn:aws:redshift-serverless:us-east-1:123456789012:workgroup/my-workgroup"
            ]
        }
    ]
}

Contoh kebijakan untuk beberapa sumber daya:

{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "redshift:GetIdentityCenterAuthToken"
            ],
            "Resource": [
                "arn:aws:redshift:*:123456789012:cluster/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "redshift-serverless:GetIdentityCenterAuthToken"
            ],
            "Resource": [
                "arn:aws:redshift-serverless:*:123456789012:workgroup/*"
            ]
        }
    ]
}

Ketersediaan wilayah

Otentikasi Pusat Identitas tersedia di AWS wilayah berikut: