View a markdown version of this page

BUAT MODEL EKSTERNAL - Amazon Redshift
PrasyaratHak istimewa yang diperlukanPengendalian biayaSintaksisParameter dan pengaturanParameter fungsi inferensi

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.

BUAT MODEL EKSTERNAL

Prasyarat untuk MEMBUAT MODEL EKSTERNAL

Sebelum Anda menggunakan pernyataan CREATE EXTERNAL MODEL, lengkapi prasyarat diPenyiapan klaster untuk menggunakan Amazon Redshift ML. Berikut ini adalah ringkasan prasyarat tingkat tinggi.

  • Buat cluster Amazon Redshift dengan AWS Management Console atau AWS Command Line Interface (AWS CLI).

  • Lampirkan kebijakan AWS Identitas dan Manajemen Akses (IAM) saat membuat cluster.

  • Agar Amazon Redshift dan Amazon Bedrock dapat mengambil peran untuk berinteraksi dengan layanan lain, tambahkan kebijakan kepercayaan yang sesuai ke peran IAM.

  • Aktifkan akses ke LLM tertentu yang ingin Anda gunakan dari konsol Amazon Bedrock.

  • (Opsional) Jika Anda menemukan pengecualian pelambatan yang berasal dari Amazon Bedrock sepertiToo many requests, please wait before trying again, bahkan dengan sejumlah kecil data, periksa kuota di bawah Kuota Layanan di akun Amazon Bedrock Anda. Periksa apakah kuota tingkat akun yang diterapkan setidaknya sama dengan nilai kuota AWS default untuk InvokeModel permintaan untuk model yang Anda gunakan.

Untuk detail peran IAM, kebijakan kepercayaan, dan prasyarat lainnya, lihatPenyiapan klaster untuk menggunakan Amazon Redshift ML.

Hak istimewa yang diperlukan

Berikut ini adalah hak istimewa yang diperlukan untuk MEMBUAT MODEL EKSTERNAL:

  • Superuser

  • Pengguna dengan hak istimewa CREATE MODEL

  • Peran dengan hak istimewa GRANT CREATE MODEL

Pengendalian biaya

Amazon Redshift ML menggunakan sumber daya cluster yang ada untuk membuat model prediksi, jadi Anda tidak perlu membayar biaya tambahan. Namun, AWS biaya untuk menggunakan Amazon Bedrock berdasarkan model yang Anda pilih. Untuk informasi selengkapnya, lihat Biaya untuk menggunakan Amazon Redshift ML.

BUAT sintaks MODEL EKSTERNAL

Berikut ini adalah sintaks lengkap dari pernyataan CREATE EXTERNAL MODEL.

CREATE EXTERNAL MODEL model_name 
FUNCTION function_name
IAM_ROLE {default/'arn:aws:iam::<account-id>:role/<role-name>'}
MODEL_TYPE BEDROCK
SETTINGS (
   MODEL_ID model_id
   [, PROMPT 'prompt prefix']
   [, SUFFIX 'prompt suffix']
   [, REQUEST_TYPE {RAW|UNIFIED}]
   [, RESPONSE_TYPE {VARCHAR|SUPER}]
);

Per CREATE EXTERNAL MODEL intah membuat fungsi inferensi yang Anda gunakan untuk menghasilkan konten.

Berikut ini adalah sintaks dari fungsi inferensi yang dibuat CREATE EXTERNAL MODEL menggunakan a REQUEST_TYPE of: RAW 

SELECT inference_function_name(request_super) 
[FROM table];

Berikut ini adalah sintaks dari fungsi inferensi yang dibuat CREATE EXTERNAL MODEL menggunakan a REQUEST_TYPE of: UNIFIED 

SELECT inference_function_name(input_text, [, inference_config [, additional_model_request_fields]])
[FROM table];

Untuk informasi tentang cara menggunakan fungsi inferensi, lihatMenggunakan model eksternal untuk integrasi Amazon Redshift MLdengan Amazon Bedrock.

BUAT parameter dan pengaturan MODEL EKSTERNAL

Bagian ini menjelaskan parameter dan pengaturan untuk CREATE EXTERNAL MODEL perintah.

BUAT parameter MODEL EKSTERNAL

nama_model

Nama untuk model eksternal. Nama model dalam skema harus unik.

Fungsi nam a_fungsi (data_type [,...])

Nama untuk fungsi inferensi yang CREATE EXTERNAL MODEL menciptakan. Anda menggunakan fungsi inferensi untuk mengirim permintaan ke Amazon Bedrock dan mengambil ML-generated teks.

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

Peran IAM yang digunakan Amazon Redshift untuk mengakses Amazon Bedrock. Untuk informasi tentang peran IAM, lihat Membuat atau memperbarui peran IAM untuk integrasi Amazon Redshift MLdengan Amazon Bedrock.

MODEL_TYPE BATUAN DASAR

Menentukan tipe model. Satu-satunya nilai yang valid adalah BEDROCK.

PENGATURAN (MODEL_ID model_id [,...])

Menentukan pengaturan model eksternal. Lihat bagian berikut untuk detailnya.

BUAT pengaturan MODEL EKSTERNAL

Model_ID model_id

Pengidentifikasi untuk model eksternal, misalnya,anthropic.claude-v2. Untuk informasi tentang ID model Amazon Bedrock, lihat ID model Amazon Bedrock.

PROMPT 'prefiks prompt'

Menentukan prompt statis yang ditambahkan Amazon Redshift ke awal setiap permintaan inferensi. Hanya didukung dengan a REQUEST_TYPE ofUNIFIED.

AKHIRAN 'akhiran prompt'

Menentukan prompt statis yang ditambahkan Amazon Redshift ke akhir setiap permintaan inferensi. Hanya didukung dengan a REQUEST_TYPE ofUNIFIED.

REQUEST_TYPE {MENTAH | TERPADU}

Menentukan format permintaan yang dikirim ke Amazon Bedrock. Nilai-nilai yang valid meliputi:

  • RAW: Fungsi inferensi mengambil input sebagai nilai super tunggal, dan selalu mengembalikan nilai super. Format nilai super khusus untuk model Amazon Bedrock yang dipilih. Super adalah model prediksi yang menggabungkan beberapa algoritma untuk menghasilkan satu prediksi yang lebih baik.

  • UNIFIED: Fungsi inferensi menggunakan API terpadu. Semua model memiliki antarmuka yang terpadu dan konsisten dengan Amazon Bedrock. Ini berfungsi untuk semua model yang mendukung pesan. Nilai ini adalah default.

    Untuk informasi selengkapnya, lihat dokumentasi API Converse di dokumentasi Amazon Bedrock API.

RESPONSE_TYPE {VARCHAR | SUPER}

Menentukan format respons. Jika REQUEST_TYPE yaRAW, RESPONSE_TYPE diperlukan dan satu-satunya nilai yang valid adalahSUPER. Untuk semua REQUEST TYPE nilai lainnya, nilai defaultnya adalahVARCHAR, dan RESPONSE_TYPE opsional. Nilai-nilai yang valid meliputi:

  • VARCHAR: Amazon Redshift hanya mengembalikan respons teks yang dihasilkan oleh model.

  • SUPER: Amazon Redshift mengembalikan seluruh respons JSON yang dihasilkan oleh model sebagai super. Ini termasuk respons teks, dan informasi seperti alasan berhenti, dan penggunaan token input dan output model. Super adalah model prediksi yang menggabungkan beberapa algoritma untuk menghasilkan satu prediksi yang lebih baik.

BUAT parameter fungsi inferensi MODEL EKSTERNAL

Bagian ini menjelaskan parameter yang valid untuk fungsi inferensi yang dibuat CREATE EXTERNAL MODEL perintah.

BUAT parameter fungsi inferensi MODEL EKSTERNAL untuk REQUEST_TYPE RAW

Fungsi inferensi yang dibuat dengan a REQUEST_TYPE of RAW memiliki satu argumen input super dan selalu mengembalikan tipe data super. Sintaks input super mengikuti sintaks permintaan model spesifik yang dipilih dari Amazon Bedrock.

BUAT parameter fungsi inferensi MODEL EKSTERNAL untuk REQUEST_TYPE dari UNIFIED

input_text

Teks yang dikirim Amazon Redshift ke Amazon Bedrock.

inference_config

Nilai super yang berisi parameter opsional yang dikirim Amazon Redshift ke Amazon Bedrock. Ini dapat mencakup yang berikut:

  • MaxToken

  • StopSequences

  • suhu

  • TOP

Parameter ini semuanya opsional dan semuanya peka huruf besar/kecil. Untuk informasi tentang parameter ini, lihat InferenceConfiguration di Refer ensi API Amazon Bedrock.