Amazon Redshift non supporterà più l'uso delle UDF Python dopo il 30 giugno 2026. Inizieremo ad applicarlo gradualmente. Per ulteriori informazioni sui dettagli della fine del ciclo di vita e sulle opzioni di migrazione di Python, consulta la post sul blog
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à.
Richiamo di stored procedure tra database e condivisione dei dati
Con Amazon Redshift, puoi richiamare le stored procedure tra database e tramite la condivisione dei dati. Mentre sei connesso a un database, puoi chiamare una stored procedure in un altro database sullo stesso cluster. Puoi anche chiamare una procedura che un produttore condivide con te tramite una condivisione di dati. Questo argomento spiega come utilizzare questa funzionalità e le relative limitazioni.
Gli esempi in questa sezione utilizzano un database di produttori denominato producer_db che viene condiviso tramite la condivisione dei dati salesshare. Per quanto riguarda il consumatore, datashare_db è il database creato da quella condivisione di dati e consumer_db è un database locale per il consumatore.
Condivisione e chiamata di una procedura
Per condividere una procedura, concedi EXECUTE trasferiscilo alla condivisione dati e consenti al consumatore di accedere alla condivisione dati.
Per chiamare una stored procedure remota, esegui prima USE per impostare il contesto del database sul database che contiene la procedura. Per una procedura condivisa tramite una condivisione dati, si tratta del database creato dalla condivisione dati. Chiamate quindi la procedura con il nome composto da una, due o tre parti. È necessario eseguire USE anche quando si chiama la procedura con il suo nome in tre parti.
-- On the producer, in producer_db CREATE PROCEDURE public.refresh_summary(p_region varchar) AS $$ BEGIN DELETE FROM public.sales_summary WHERE region = p_region; INSERT INTO public.sales_summary SELECT region, SUM(amount) FROM public.sales WHERE region = p_region GROUP BY region; END; $$ LANGUAGE plpgsql; CREATE DATASHARE salesshare; GRANT USAGE ON SCHEMA public TO DATASHARE salesshare; GRANT SELECT ON public.sales TO DATASHARE salesshare; GRANT SELECT, INSERT, DELETE ON public.sales_summary TO DATASHARE salesshare; GRANT EXECUTE ON PROCEDURE public.refresh_summary(varchar) TO DATASHARE salesshare; GRANT USAGE ON DATASHARE salesshare TO NAMESPACE 'consumer-namespace-id';
Sul consumatore, create un database dalla condivisione dati, impostate il contesto del database e richiamate la procedura.
-- On the consumer, in consumer_db CREATE DATABASE datashare_db FROM DATASHARE salesshare OF NAMESPACE 'producer-namespace-id'; USE datashare_db; -- Three-part name CALL datashare_db.public.refresh_summary('WEST'); -- Two-part name CALL public.refresh_summary('WEST'); -- One-part name SET search_path TO public; CALL refresh_summary('WEST');
Per interrompere la condivisione della procedura, revoca EXECUTE su di esso dalla condivisione dei dati.
-- On the producer REVOKE EXECUTE ON PROCEDURE public.refresh_summary(varchar) FROM DATASHARE salesshare;
Come si risolvono i nomi degli oggetti
-
One-part e i nomi in due parti nel corpo della procedura vengono risolti nel database impostato da
USE, quindipublic.salessi riferisce adatashare_db.public.sales. -
Three-part i nomi si risolvono allo stesso modo di qualsiasi altra dichiarazione fornita al consumatore. Utilizza il nome utente di un database condiviso, ad esempio
datashare_dbo il nome di un database locale del consumatore. -
Le stesse regole si applicano all'SQL dinamico con cui viene eseguita la procedura
EXECUTEe alle procedure che richiama.
La procedura seguente confronta un totale nella tabella condivisa con un totale in una tabella locale per il consumatore.
-- On the producer, in producer_db CREATE PROCEDURE public.compare_totals(p_region varchar) AS $$ DECLARE shared_total decimal(12,2); local_total decimal(12,2); BEGIN SELECT SUM(amount) INTO shared_total FROM datashare_db.public.sales WHERE region = p_region; SELECT SUM(total) INTO local_total FROM consumer_db.public.regional_totals WHERE region = p_region; RAISE INFO 'shared: %, local: %', shared_total, local_total; END; $$ LANGUAGE plpgsql; GRANT EXECUTE ON PROCEDURE public.compare_totals(varchar) TO DATASHARE salesshare;
-- On the consumer, in consumer_db USE datashare_db; CALL datashare_db.public.compare_totals('WEST'); INFO: shared: 150.00, local: 150.00
Scrittura su più di un database
Una transazione può scrivere su un solo database. Dopo USE datashare_db, le scritture che utilizzano nomi composti da una o due parti vanno al database condiviso. Per scrivere su un altro database, la procedura esegue il commit della transazione corrente, viene eseguita USE per modificare il contesto del database e quindi scrive con nomi composti da una o due parti. Esegui COMMIT immediatamente prima di ciascuno USE nel corpo della procedura.
A USE o RESET USE nel corpo della procedura si applica alle istruzioni che la seguono e rimane in vigore nella sessione dopo il ritorno della procedura. Dopo RESET USE, le istruzioni vengono eseguite nel database a cui sei connesso sul consumatore.
La procedura seguente aggiorna un riepilogo nel database condiviso e quindi scrive una riga di registro in un database locale del consumatore.
-- On the producer, in producer_db CREATE PROCEDURE public.summarize_and_log(p_region varchar) AS $$ BEGIN DELETE FROM public.sales_summary WHERE region = p_region; INSERT INTO public.sales_summary SELECT region, SUM(amount) FROM public.sales WHERE region = p_region GROUP BY region; COMMIT; USE consumer_db; INSERT INTO public.run_log VALUES (p_region, GETDATE()); END; $$ LANGUAGE plpgsql; GRANT EXECUTE ON PROCEDURE public.summarize_and_log(varchar) TO DATASHARE salesshare;
-- On the consumer, in consumer_db USE datashare_db; CALL datashare_db.public.summarize_and_log('EAST'); SHOW USE; Use Database -------------- consumer_db
Limitazioni
Le seguenti limitazioni si applicano alle procedure richiamate tra database o tramite la condivisione dei dati:
-
Non è possibile richiamare una procedura creata con
SECURITY DEFINER. -
Non puoi chiamare un
NONATOMICprocedura tramite condivisione dei dati. -
Non è possibile chiamare una procedura tramite una condivisione di dati condivisa con un'altra AWS account o tramite una condivisione di dati gestita da Lake Formation.
-
Non è possibile chiamare una procedura in un database creato da una condivisione di dati con
WITH PERMISSIONSclausola. -
Non è possibile creare, sostituire o eliminare una procedura in un altro database. Eseguite questi comandi nel database che contiene la procedura.
-
Non è possibile chiamare una procedura tramite uno schema esterno. Esegui
USEinvece. -
La procedura non può utilizzare
%TYPEattributo. -
Le istruzioni della procedura si comportano nello stesso modo di quando vengono eseguite sull'altro database o tramite la condivisione dei dati, non come istruzioni locali. Ad esempio
TRUNCATEsu una tabella del database condiviso non esegue il commit della transazione, quindi in un secondo momentoROLLBACKnella procedura annulla anche ilTRUNCATE.