Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Usare PL/Rust per scrivere SQL funzioni Postgre nel linguaggio Rust

PL/Rust è un'estensione affidabile del linguaggio Rust per Postgre. SQL È possibile utilizzarlo per procedure memorizzate, funzioni e altro codice procedurale da cui è possibile richiamare. SQL L'estensione del linguaggio PL/Rust è disponibile nelle seguenti versioni:

Per ulteriori informazioni, vedere PL/Rust on. GitHub

Configurazione di PL/Rust

Per installare l'estensione plrust sull'istanza database, aggiungere plrust al parametro shared_preload_libraries nel gruppo di parametri database associato all'istanza database. Dopo aver installato l'estensione plrust, è possibile creare funzioni.

Per modificare il parametro shared_preload_libraries, l'istanza database deve essere associata a un gruppo di parametri personalizzato. Per ulteriori informazioni sulla creazione di un gruppo di parametri personalizzato, consulta Gruppi di parametri per RDS.

È possibile installare l'estensione plrust utilizzando o il AWS Management Console . AWS CLI

I passaggi seguenti si basano sull'ipotesi che l'istanza database sia associata a un gruppo di parametri personalizzato.

Creazione di funzioni con PL/Rust

PL/Rust compilerà la funzione come libreria dinamica, la caricherà e la eseguirà.

La seguente funzione Rust filtra i multipli da un array.

postgres=> CREATE LANGUAGE plrust;
CREATE EXTENSION            

CREATE OR REPLACE FUNCTION filter_multiples(a BIGINT[], multiple BIGINT) RETURNS BIGINT[]
    IMMUTABLE STRICT
    LANGUAGE PLRUST AS
$$
    Ok(Some(a.into_iter().filter(|x| x.unwrap() % multiple != 0).collect()))
$$;
        
WITH gen_values AS (
SELECT ARRAY(SELECT * FROM generate_series(1,100)) as arr)
SELECT filter_multiples(arr, 3)
from gen_values;

Utilizzo dei formati crate con PL/Rust

RDSPer SQL le versioni 16.3-R2 e successive di Postgre, 15.7-R2 e successive 15 versioni, 14.12-R2 e 14 versioni successive e 13.15-R2 e versioni successive 13, PL/Rust supporta casse aggiuntive:

RDSPer le SQL versioni 15.5-R2 e successive di Postgre, 14.10-R2 e successive 14 versioni e 13.13-R2 e versioni successive 13, PL/Rust supporta due casse aggiuntive:

A partire dalle SQL versioni 15.4, 14.9 e 13.12 di Amazon RDS for Postgre, PL/Rust supporta le seguenti casse:

Per questi formati sono supportate solo le funzionalità predefinite. Le nuove versioni RDS di Postgre potrebbero contenere SQL versioni aggiornate delle casse e le versioni precedenti delle casse potrebbero non essere più supportate.

Segui le best practice per eseguire un aggiornamento della versione principale per verificare se le tue funzioni PL/Rust sono compatibili con la nuova versione principale. Per ulteriori informazioni, consulta il blog Le migliori pratiche per l'aggiornamento di Amazon RDS alle versioni principali e secondarie di Postgre e l'aggiornamento del motore SQL Postgre DB SQL per Amazon nella Amazon User Guide. RDS RDS

Esempi di utilizzo delle dipendenze durante la creazione di una funzione PL/Rust sono disponibili in Use dependencies (Utilizzo delle dipendenze).

Limitazioni del linguaggio PL/Rust

Per impostazione predefinita, gli utenti del database non possono utilizzare PL/Rust. Per fornire l'accesso a PL/Rust, connettersi come utente con il privilegio rds_superuser ed eseguire il seguente comando:

postgres=> GRANT USAGE ON LANGUAGE PLRUST TO user;