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

Membuat Lambda skalar UDF

Amazon Redshift dapat menggunakan fungsi kustom yang didefinisikan AWS Lambda sebagai bagian dari SQL kueri. Anda dapat menulis skalar UDFs Lambda dalam bahasa pemrograman apa pun yang didukung oleh Lambda, seperti Java, Go,, Node.js, C # PowerShell, Python, dan Ruby. Atau Anda dapat menggunakan runtime khusus.

Lambda UDFs didefinisikan dan dikelola di Lambda, dan Anda dapat mengontrol hak akses untuk memanggilnya di Amazon Redshift. UDFs Anda dapat memanggil beberapa fungsi Lambda dalam kueri yang sama atau menjalankan fungsi yang sama beberapa kali.

Gunakan Lambda UDFs dalam klausa SQL pernyataan di mana fungsi skalar didukung. Anda juga dapat menggunakan Lambda UDFs dalam SQL pernyataan apa pun sepertiSELECT,, UPDATEINSERT, atau. DELETE

Mendaftarkan Lambda UDF

CREATE EXTERNAL FUNCTIONPerintah membuat parameter berikut:

Untuk informasi tentang CREATE EXTERNALFUNCTION, lihatCREATE EXTERNAL FUNCTION.

Tipe data input dan pengembalian untuk fungsi ini dapat berupa tipe data Amazon Redshift standar apa pun.

Amazon Redshift memastikan bahwa fungsi eksternal dapat mengirim dan menerima argumen dan hasil batch.

Mengelola UDF keamanan dan hak istimewa Lambda

Untuk membuat LambdaUDF, pastikan Anda memiliki izin untuk penggunaan di file. LANGUAGE EXFUNC Anda harus secara eksplisit memberikan USAGE ON LANGUAGE EXFUNC atau mencabut USAGE ON LANGUAGE EXFUNC kepada pengguna, grup, atau publik tertentu.

Contoh berikut memberikan penggunaan EXFUNC kePUBLIC.

grant usage on language exfunc to PUBLIC; 

Contoh berikut mencabut penggunaan pada exfunc from PUBLIC dan kemudian memberikan penggunaan ke grup pengguna lambda_udf_devs.

revoke usage on language exfunc from PUBLIC;
grant usage on language exfunc to group lambda_udf_devs;

Untuk menjalankan LambdaUDF, pastikan Anda memiliki izin untuk setiap fungsi yang dipanggil. Secara default, izin untuk menjalankan Lambda baru UDFs diberikan kepada. PUBLIC Untuk membatasi penggunaan, cabut izin ini dari PUBLIC fungsi tersebut. Kemudian, berikan hak istimewa kepada pengguna atau grup tertentu.

Contoh berikut mencabut eksekusi pada fungsi exfunc_sum dari. PUBLIC Kemudian, itu memberikan penggunaan ke grup pengguna lambda_udf_devs.

revoke execute on function exfunc_sum(int, int) from PUBLIC;
grant execute on function exfunc_sum(int, int) to group lambda_udf_devs;

Superuser memiliki semua hak istimewa secara default.

Untuk informasi selengkapnya tentang pemberian dan pencabutan hak istimewa, lihat dan. GRANT REVOKE

Mengkonfigurasi parameter otorisasi untuk Lambda UDFs

CREATEEXTERNALFUNCTIONPerintah tersebut memerlukan otorisasi untuk menjalankan fungsi Lambda di. AWS Lambda Untuk memulai otorisasi, tentukan peran AWS Identity and Access Management (IAM) saat Anda menjalankan CREATE EXTERNAL FUNCTION perintah. Untuk informasi selengkapnya tentang IAM peran, lihat IAMperan di Panduan IAM Pengguna.

Jika ada IAM peran yang ada dengan izin untuk memanggil fungsi Lambda yang dilampirkan ke klaster Anda, Anda dapat mengganti peran Amazon Resource Name (ARN) di ROLE parameter IAM _ untuk perintah. Bagian berikut menjelaskan langkah-langkah untuk menggunakan IAM peran dalam CREATE EXTERNAL FUNCTION perintah.

Membuat IAM peran untuk Lambda

IAMPeran tersebut memerlukan izin untuk menjalankan fungsi Lambda. Saat membuat IAM peran, berikan izin dengan salah satu cara berikut:

Untuk langkah-langkah membuat IAM peran, lihat Mengotorisasi Amazon Redshift untuk mengakses layanan AWS lain atas nama Anda di Panduan Manajemen Amazon Redshift.

Jika Anda tidak ingin membuat IAM peran baru, Anda dapat menambahkan izin yang disebutkan sebelumnya ke IAM peran yang ada.

Mengaitkan IAM peran dengan cluster

Lampirkan IAM peran ke cluster Anda. Anda dapat menambahkan peran ke klaster atau melihat peran yang terkait dengan klaster menggunakan Amazon Redshift Management Console,CLI, atau. API Untuk informasi selengkapnya, lihat Mengaitkan IAM Peran Dengan Cluster di Panduan Manajemen Pergeseran Merah Amazon.

Termasuk IAM peran dalam perintah

Sertakan IAM peran ARN dalam CREATE EXTERNAL FUNCTION perintah. Saat Anda membuat IAM peran, IAM mengembalikan Amazon Resource Name (ARN) untuk peran tersebut. Untuk menentukan IAM peran, berikan peran ARN dengan IAM_ROLE parameter. Berikut ini menunjukkan sintaks untuk IAM_ROLE parameter.

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

Untuk menjalankan fungsi Lambda yang berada di akun lain dalam Wilayah yang sama, lihat IAM Peran rantai di Amazon Redshift.

Menggunakan JSON antarmuka antara Amazon Redshift dan AWS Lambda

Amazon Redshift menggunakan antarmuka umum untuk semua fungsi Lambda yang dikomunikasikan oleh Amazon Redshift.

Tabel berikut menunjukkan daftar kolom input yang fungsi Lambda yang ditunjuk yang dapat Anda harapkan untuk payload. JSON

Urutan JSON array menentukan urutan pemrosesan batch. Fungsi Lambda harus memproses argumen secara iteratif dan menghasilkan jumlah catatan yang tepat. Berikut ini adalah contoh payload.

{
  "request_id" : "23FF1F97-F28A-44AA-AB67-266ED976BF40",
  "cluster" : "arn:aws:redshift:xxxx",
  "user" : "adminuser",
  "database" : "db1",
  "external_function": "public.foo",
  "query_id" : 5678234,
  "num_records" : 4,
  "arguments" : [
     [ 1, 2 ],
     [ 3, null],
     null,
     [ 4, 6]
   ]
 }

Output kembali dari fungsi Lambda berisi bidang-bidang berikut.

Berikut ini adalah contoh dari output fungsi Lambda.

{
  "success": true,   // true indicates the call succeeded
  "error_msg" : "my function isn't working",  // shall only exist when success != true
  "num_records": 4,      // number of records in this payload
  "results" : [
     1,
     4,
     null,
     7
   ]
}

Saat Anda memanggil fungsi Lambda dari SQL kueri, Amazon Redshift memastikan keamanan koneksi dengan pertimbangan berikut: