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.

Menghubungkan ke Amazon Redshift Serverless

Setelah menyiapkan instans Amazon Redshift Serverless, Anda dapat menghubungkannya dengan berbagai metode, yang diuraikan di bawah ini. Jika Anda memiliki beberapa tim atau proyek dan ingin mengelola biaya secara terpisah, Anda dapat menggunakan terpisah Akun AWS.

Untuk daftar Wilayah AWS di mana Amazon Redshift Serverless tersedia, lihat titik akhir yang terdaftar untuk Redshift Serverless API di. Referensi Umum Amazon Web Services

Amazon Redshift Serverless terhubung ke lingkungan tanpa server Akun AWS di Anda saat ini. Wilayah AWS Amazon Redshift Serverless berjalan di VPC dalam rentang port 5431-5455 dan 8191-8215. Defaultnya adalah 5439. Saat ini, Anda hanya dapat mengubah port dengan operasi API UpdateWorkgroup dan AWS CLI operasiupdate-workgroup.

Menghubungkan ke Amazon Redshift Serverless

Anda dapat terhubung ke database (bernamadev) di Amazon Redshift Serverless dengan sintaks berikut.

workgroup-name.account-number.aws-region.redshift-serverless.amazonaws.com:port/dev

Misalnya, string koneksi berikut menentukan Region us-east-1.

default.123456789012.us-east-1.redshift-serverless.amazonaws.com:5439/dev

Menghubungkan ke Amazon Redshift Serverless melalui driver JDBC

Anda dapat menggunakan salah satu metode berikut untuk menyambung ke Amazon Redshift Serverless dengan klien SQL pilihan Anda menggunakan driver Amazon Redshift-provided JDBC versi 2.x.

Untuk terhubung dengan kredentif masuk untuk otentikasi database menggunakan driver JDBC versi 2.x, gunakan sintaks berikut. Nomor port adalah opsional; jika tidak disertakan, Amazon Redshift Serverless default ke nomor port 5439. Anda dapat mengubah ke port lain dari rentang port 5431-5455 atau 8191-8215. Untuk mengubah port default untuk titik akhir tanpa server, gunakan AWS CLI dan Amazon Redshift API.

jdbc:redshift://workgroup-name.account-number.aws-region.redshift-serverless.amazonaws.com:5439/dev

Misalnya, string koneksi berikut menentukan default workgroup, ID akun 123456789012, dan Region us-east-2.

jdbc:redshift://default.123456789012.us-east-2.redshift-serverless.amazonaws.com:5439/dev

Untuk terhubung dengan IAM menggunakan driver JDBC versi 2.x, gunakan sintaks berikut. Nomor port adalah opsional; jika tidak disertakan, Amazon Redshift Serverless default ke nomor port 5439. Anda dapat mengubah ke port lain dari rentang port 5431-5455 atau 8191-8215. Untuk mengubah port default untuk titik akhir tanpa server, gunakan AWS CLI dan Amazon Redshift API.

jdbc:redshift:iam://workgroup-name.account-number.aws-region.redshift-serverless.amazonaws.com:5439/dev

Misalnya, string koneksi berikut menentukan default workgroup, ID akun 123456789012, dan Region us-east-2.

jdbc:redshift:iam://default.123456789012.us-east-2.redshift-serverless.amazonaws.com:5439/dev

Untuk ODBC, gunakan sintaks berikut.

Driver={Amazon Redshift (x64)}; Server=workgroup-name.account-number.aws-region.redshift-serverless.amazonaws.com; Database=dev

Jika Anda menggunakan versi driver JDBC sebelum 2.1.0.9 dan terhubung dengan IAM, Anda harus menggunakan sintaks berikut.

jdbc:redshift:iam://redshift-serverless-<name>:aws-region/database-name

Misalnya, string koneksi berikut menentukan default workgroup dan Wilayah AWS us-east-1.

jdbc:redshift:iam://redshift-serverless-default:us-east-1/dev

Untuk informasi lebih lanjut tentang driver, lihatMengkonfigurasi koneksi di Amazon Redshift.

Menemukan string koneksi JDBC dan ODBC Anda

Untuk terhubung ke workgroup Anda dengan alat klien SQL Anda, Anda harus memiliki string koneksi JDBC atau ODBC. Anda dapat menemukan string koneksi di konsol Amazon Redshift Serverless, di halaman detail grup kerja.

Menghubungkan ke Amazon Redshift Serverless dengan API Data

Anda juga dapat menggunakan Amazon Redshift Data API untuk terhubung ke Amazon Redshift Serverless. Gunakan workgroup-name parameter alih-alih cluster-identifier parameter dalam AWS CLI panggilan Anda.

Untuk informasi selengkapnya tentang API Data, lihatMenggunakan API Data Amazon Redshift. Misalnya kode yang memanggil API Data di Python dan contoh lainnya, lihat Memulai dengan Redshift Data API dan lihat di use-cases folder quick-start and di GitHub.

Menghubungkan dengan SSL ke Amazon Redshift Serverless

Mengkonfigurasi koneksi aman ke Amazon Redshift Serverless

Untuk mendukung koneksi SSL, Redshift Serverless membuat dan menginstal sertifikat SSL yang dikeluarkan AWS Certificate Manager (ACM) untuk setiap kelompok kerja. Sertifikat ACM dipercaya secara publik oleh sebagian besar sistem operasi, browser web, dan klien. Anda mungkin perlu mengunduh bundel sertifikat jika klien atau aplikasi SQL Anda terhubung ke Redshift Serverless menggunakan SSL dengan opsi sslmode koneksi disetel ke, requireverify-ca, atau. verify-full Jika klien Anda memerlukan sertifikat, Redshift Serverless menyediakan sertifikat bundel sebagai berikut:

Secara default, database workgroup menerima koneksi apakah menggunakan SSL atau tidak.

Untuk membuat workgroup baru yang hanya menerima koneksi SSL, gunakan create-workgroup perintah dan atur require_ssl parameter ketrue. Untuk menggunakan contoh berikut, ganti yourNamespaceName dengan nama namespace Anda dan ganti yourWorkgroupName dengan nama workgroup Anda.

aws redshift-serverless create-workgroup \
--namespace-name yourNamespaceName \
--workgroup-name yourWorkgroupName \
--config-parameters parameterKey=require_ssl,parameterValue=true

Untuk memperbarui workgroup yang ada agar hanya menerima koneksi SSL, gunakan update-workgroup perintah dan atur require_ssl parameter ketrue. Perhatikan bahwa Redshift Serverless akan memulai ulang grup kerja Anda saat Anda memperbarui parameter. require_ssl Untuk menggunakan contoh berikut, ganti yourWorkgroupName dengan nama workgroup Anda.

aws redshift-serverless update-workgroup \
--workgroup-name yourWorkgroupName \
--config-parameters parameterKey=require_ssl,parameterValue=true

Amazon Redshift mendukung protokol perjanjian kunci Elliptic Curve Diffie—Hellman Ephemeral (ECDHE). Dengan ECDHE, klien dan server masing-masing memiliki kurva elips pasangan kunci publik-pribadi yang digunakan untuk membuat rahasia bersama melalui saluran yang tidak aman. Anda tidak perlu mengonfigurasi apa pun di Amazon Redshift untuk mengaktifkan ECDHE. Jika Anda terhubung dari alat klien SQL yang menggunakan ECDHE untuk mengenkripsi komunikasi antara klien dan server, Amazon Redshift menggunakan daftar sandi yang disediakan untuk membuat koneksi yang sesuai. Untuk informasi lebih lanjut, lihat Elliptic curve diffie—hellman di Wikipedia dan Ci phers di situs web OpenSSL.

Mengkonfigurasi koneksi FIPS-compliant SSL ke Amazon Redshift Serverless

Untuk membuat workgroup baru yang menggunakan koneksi FIPS-compliant SSL, gunakan create-workgroup perintah dan atur require_ssl parameter use_fips_ssl dan ketrue. Untuk menggunakan contoh berikut, ganti yourNamespaceName dengan nama namespace Anda dan ganti yourWorkgroupName dengan nama workgroup Anda.

aws redshift-serverless create-workgroup \
--namespace-name yourNamespaceName \
--workgroup-name yourWorkgroupName \
--config-parameters '[{"parameterKey": "require_ssl", "parameterValue": "true"}, {"parameterKey": "use_fips_ssl", "parameterValue": "true"}]'

Untuk memperbarui workgroup yang ada untuk menggunakan koneksi FIPS-compliant SSL, gunakan update-workgroup perintah dan atur require_ssl parameter use_fips_ssl dan ketrue. Perhatikan bahwa Redshift Serverless akan memulai ulang grup kerja Anda saat Anda memperbarui parameter. use_fips_ssl Untuk menggunakan contoh berikut, ganti yourWorkgroupName dengan nama workgroup Anda.

aws redshift-serverless update-workgroup \
--workgroup-name yourWorkgroupName \
--config-parameters '[{"parameterKey": "require_ssl", "parameterValue": "true"}, {"parameterKey": "use_fips_ssl", "parameterValue": "true"}]'

Untuk informasi selengkapnya tentang mengonfigurasi Redshift Serverless untuk menggunakan FIPS-compliant koneksi, lihat use_fips_ssl di Panduan Pengembang Database Amazon Redshift.

Menghubungkan ke Amazon Redshift Serverless dari titik akhir VPC yang dikelola Amazon Redshift

Menghubungkan ke Amazon Redshift Serverless dari titik akhir VPC lainnya

Untuk informasi tentang menyiapkan atau mengonfigurasi titik akhir VPC terkelola untuk grup kerja Amazon Redshift Serverless, lihat Bekerja dengan titik akhir VPC. Redshift-managed

Menghubungkan ke Amazon Redshift Serverless dari titik akhir VPC antarmuka (AWS PrivateLink)

Untuk informasi tentang menghubungkan ke Amazon Redshift Serverless dari antarmuka titik akhir VPC (AWS PrivateLink), lihat. Titik akhir VPC antarmuka

Menghubungkan ke Amazon Redshift Serverless dari titik akhir VPC Redshift di akun lain

Menghubungkan ke Amazon Redshift Serverless dari titik akhir VPC silang

Amazon Redshift Serverless disediakan di VPC. Anda dapat memberikan akses ke VPC di akun lain untuk mengakses Amazon Redshift Serverless di akun Anda. Ini mirip dengan koneksi dari titik akhir VPC terkelola, tetapi dalam hal ini koneksi berasal, misalnya, dari klien database di akun lain. Ada beberapa operasi yang dapat Anda lakukan:

Manfaat utama dari akses lintas akun adalah memungkinkan kolaborasi database yang lebih mudah. Pengguna tidak harus disediakan di akun yang berisi database untuk mengaksesnya, yang mengurangi langkah-langkah konfigurasi dan menghemat waktu.

Izin diperlukan untuk memberikan akses ke VPC di akun lain

Untuk memberikan akses atau mengubah akses yang diizinkan, pemberi memerlukan kebijakan izin yang ditetapkan dengan izin berikut:

Anda mungkin memerlukan izin lain yang ditentukan dalam kebijakan ter AWS kelola AmazonRedshiftFullAccess. Untuk informasi selengkapnya, lihat Memberikan izin ke Amazon Redshift Server less.

Penerima hibah memerlukan kebijakan izin yang ditetapkan dengan izin berikut:

Sebagai praktik terbaik, sebaiknya lampirkan kebijakan izin ke peran IAM dan kemudian menetapkannya ke pengguna dan grup sesuai kebutuhan. Untuk informasi selengkapnya, lihat Identitas dan manajemen akses di Amazon Redshift.

Ini adalah contoh kebijakan sumber daya yang digunakan untuk mengonfigurasi akses lintas VPC:

JSON

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "CrossAccountCrossVPCAccess",
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "123456789012",
                    "234567890123"
                ]
            },
            "Action": [
                "redshift-serverless:CreateEndpointAccess",
                "redshift-serverless:UpdateEndpointAccess",
                "redshift-serverless:DeleteEndpointAccess",
                "redshift-serverless:GetEndpointAccess"
            ],
            "Resource": "arn:aws:redshift-serverless:*:*:*",
            "Condition": {
                "StringEquals": {
                    "aws:RequestedRegion": "us-east-1"
                },
                "StringLike": {
                    "aws:SourceVpc": [
                       "vpc-11223344556677889",
                       "vpc-12345678"
                    ]
                }
            }
        }
    ]
}

Prosedur yang mengikuti di bagian ini mengasumsikan bahwa pengguna yang melakukannya memiliki izin yang ditetapkan yang sesuai, misalnya, melalui peran IAM yang ditetapkan yang memiliki izin terdaftar. Prosedur juga mengasumsikan bahwa workgroup memiliki peran IAM yang dilampirkan dengan izin sumber daya yang sesuai.

Memberikan akses VPC ke akun lain, menggunakan konsol

Prosedur ini menunjukkan langkah-langkah untuk mengonfigurasi akses database saat Anda adalah pemilik database, dan Anda ingin memberikan akses ke sana.

Saat Anda menyimpan perubahan, akun tersebut muncul dalam daftar Akun yang Diberikan. Entri menunjukkan ID Akun dan daftar VPC yang diberikan akses.

Pemilik database juga dapat mencabut akses ke akun. Pemilik dapat mencabut akses kapan saja.

Setelah akses diberikan, administrator database untuk penerima hibah dapat memeriksa konsol untuk menentukan apakah mereka memiliki akses.

Memberikan akses ke akun lain, menggunakan perintah CLI

Akun yang memberikan akses harus terlebih dahulu memberikan akses ke akun lain untuk terhubung dengan menggunakanput-resource-policy. Pemilik database dapat memanggil put-resource-policy untuk mengotorisasi akun lain untuk membuat koneksi ke workgroup. Akun penerima hibah kemudian dapat digunakan create-endpoint-authorization untuk membuat koneksi ke kelompok kerja melalui VPC yang diizinkan.

Berikut ini menunjukkan properti untukput-resource-policy, yang dapat Anda panggil untuk mengizinkan akses ke akun dan VPC tertentu.

aws redshift-serverless put-resource-policy
--resource-arn <value> 
--policy <value>

Setelah memanggil perintah, Anda dapat memanggilget-resource-policy, menentukan resource-arn untuk melihat akun dan VPC mana yang diizinkan untuk mengakses sumber daya.

Panggilan berikut dapat dilakukan oleh penerima hibah. Ini menunjukkan informasi tentang akses yang diberikan. Secara khusus, ia mengembalikan daftar yang berisi akses yang diberikan VPC.

aws redshift-serverless list-workgroups
--owner-account <value>

Tujuan dari ini adalah agar penerima hibah mendapatkan informasi dari akun pemberi tentang otorisasi titik akhir. Ini owner-account adalah akun berbagi. Ketika Anda menjalankan ini, ia mengembalikan CrossAccountVpcs untuk setiap workgroup, yang merupakan daftar VPC yang diizinkan. Sebagai referensi, berikut ini menunjukkan semua properti yang tersedia untuk kelompok kerja:

Output: workgroup (Object)
workgroupId String,
workgroupArn String,
workgroupName String,
status: String,
namespaceName: String,
baseCapacity: Integer, (Not-applicable)
enhancedVpcRouting: Boolean,
configParameters: List,
securityGroupIds: List,
subnetIds: List,
endpoint: String,
publiclyAccessible: Boolean,
creationDate: Timestamp,
port: Integer,
CrossAccountVpcs: List

Sumber daya tambahan

Petunjuk untuk mengatur pengaturan lalu lintas jaringan tersedia di Aksesibilitas publik dengan konfigurasi grup keamanan default atau kustom. Ini termasuk kasus penggunaan di mana cluster dapat diakses publik.

Petunjuk untuk mengatur setelan lalu lintas jaringan tersedia di Aksesibilitas pribadi dengan konfigurasi grup keamanan default atau kustom. Ini termasuk kasus penggunaan di mana cluster tidak tersedia untuk internet.

Untuk informasi selengkapnya tentang koneksi aman ke Amazon Redshift Serverless, termasuk memberikan izin, mengotorisasi akses ke layanan tambahan, dan membuat peran IAM, lihat. Manajemen identitas dan akses di Amazon Redshift Tanpa Server