Visualizza le categorie

Come esporre un database Oracle come API REST sicura

13 minuti di lettura

Logo Oracle ORACOLO API REST

Trasforma una query Oracle in una query sicura API REST — nessun ORDINE da erigere, nessun porto da aprire.

Salva una query SQL sul tuo database Oracle, crea una chiave API per ogni destinatario e fornisci a un partner un endpoint JSON attivo. No Servizi dati REST di Oracle per installare, non aprire 1521 ascoltatore, nessun accesso allo schema condiviso: solo un accesso di sola lettura governato. API REST di Oracle in minuti.

Nessuna porta in entrata chiavi per destinatario Modalità di sola lettura obbligatoria Nessun ORDS da ospitare

Query Streams è una piattaforma di integrazione di database sicura e in tempo reale che trasforma qualsiasi query Oracle salvata in un endpoint API REST pronto per i partner, con chiavi per destinatario, vincolo di sola lettura e tracciabilità completa delle modifiche. Ottieni una vita API REST di Oracle senza installare Oracle REST Data Services, aprire la porta di ascolto o ospitare un gateway. Per saperne di più, visita QueryStreams.com e iscriviti gratuitamente Pubblica il tuo primo endpoint Oracle in pochi minuti.

Perché esporre un database Oracle come API REST?

I dati critici per la missione risiedono in Oracle e, prima o poi, qualcuno al di fuori del tuo team ne avrà bisogno: un cliente desidera i suoi dati in una dashboard, un fornitore vuole un feed in tempo reale invece di un'estrazione notturna, un revisore ha bisogno di un set di risultati specifico. Le soluzioni usuali presentano tutte qualche problema. Si inviano esportazioni via e-mail che sono obsolete al momento della ricezione, si distribuisce un login di sola lettura dello schema che sopravvive alla conclusione del progetto, oppure si implementa Oracle REST Data Services (ORDS) e si eredita un livello intermedio Java da distribuire, proteggere, aggiornare e mantenere raggiungibile dal database. API REST di Oracle Questa è la versione pulita: il partner riceve un URL e un token, non il tuo database. La parte difficile è sempre stata costruire e gestire quell'API in modo sicuro. Query Streams la trasforma in una query salvata più una chiave.

Nessun listener Oracle aperto

Non esponi mai il 1521 ascoltatore su internet o crea una falla nel tuo firewall. L'agente di rete effettua chiamate in uscita; le chiamate in entrata tornano indietro attraverso quella connessione in uscita.

Chiavi API per destinatario

Ogni destinatario riceve il proprio qsapi_* Chiave. Revoca una senza toccare le altre e senza ruotare la password dello schema Oracle.

Sola lettura per impostazione predefinita

Un validatore di sola lettura rifiuta qualsiasi istruzione diversa da SELECT prima che raggiunga Oracle. Non c'è alcun errore accidentale AGGIORNAMENTO, UNISCI, o GOCCIOLARE percorso attraverso l'API.

Il tuo codice SQL rimane privato

Il destinatario visualizza l'URL dell'endpoint, la risposta JSON e gli eventuali filtri esposti, ma mai il codice SQL, lo schema, il nome del servizio o la stringa di connessione.

Nessun ORDS da ospitare o patchare

Nessun livello intermedio ORDS, nessun WebLogic o Jetty standalone, nessun reverse proxy. L'endpoint viene eseguito come funzionalità gestita, quindi non è necessario gestire alcuna pipeline di distribuzione o rotazione TLS.

Permanente, in scadenza o autodistruttivo

Rendi un endpoint permanente, impostane la scadenza in una data specifica oppure assegnagli un budget di chiamate fisso che lo autodistrugge dopo un determinato numero di richieste.

I metodi usuali per implementare un'API REST su Oracle e perché sono problematici

Esistono strumenti ben noti per questo scopo, e svolgono bene il loro compito. Il problema è che ognuno di essi ti lascia proprietario di un livello intermedio, di un'esposizione di rete o di entrambi. Ecco un confronto tra gli approcci comuni e un endpoint condiviso di Query Streams quando l'obiettivo è semplicemente "consentire a un partner specifico di leggere un set di risultati specifico".

Preoccupazione Servizi dati REST Oracle (ORDS) Servizio .NET/Java fai-da-te Flussi di query
Database raggiungibile tramite API Il livello intermedio deve raggiungere l'ascoltatore Deve raggiungere Oracle Agente solo in uscita — nessuna porta in entrata
Ciò che il destinatario tiene Un URL nel tuo schema abilitato per ORDS Un URL nel tuo servizio Una chiave monouso per una singola query
Esposizione dello schema Qualunque cosa tu abiliti REST, spesso è ampia Qualunque cosa tu codifichi manualmente Una sola query salvata, nient'altro.
Chiavi per destinatario + revoca Ruoli OAuth da configurare Costruiscilo tu stesso Costruito
Registro di controllo di ogni chiamata Configura + mantieni te stesso Aggiungilo tu stesso Costruito
Gestisci / patch / ruoti TLS Sì, il livello ORDS, per sempre. Sì, per sempre Gestito per te
Tempo al primo punto finale Da ore a giorni (installazione + attivazione) Giorni Minuti

Cerchi un'alternativa a ORDS per la condivisione con un partner?

Oracle REST Data Services è un'ottima soluzione quando si desidera un'interfaccia REST completa e self-hosted sul proprio schema e si è disposti a gestire il livello intermedio. Se invece si desidera fornire a un partner specifico un set di risultati governato e di sola lettura, con una propria chiave, una traccia di controllo e senza necessità di implementazione, Query Streams colma esattamente questa lacuna. I due sistemi possono coesistere: ORDS per le applicazioni interne e Query Streams per la condivisione esterna.

Come Query Streams trasforma una query Oracle in un'API REST

Una volta installato l'agente di rete e configurato il connettore Oracle, la promozione di una query salvata a un endpoint REST condiviso richiede circa tre passaggi. Se utilizzi già Query Streams per Excel, Fogli Google o il server MCP, l'agente e il connettore sono già presenti: puoi iniziare dal secondo passaggio.

1

Connetti Oracle tramite l'agente

Installa l'agente di rete accanto al tuo database e aggiungi un connettore Oracle con uno schema standard di sola lettura. L'agente stabilisce una connessione TLS in uscita verso Query Streams: il tuo listener non sarà mai esposto a Internet.

2

Salva una query SQL

Scrivi il SELEZIONARE Nel Query Builder, in relazione alla tua connessione Oracle, puoi utilizzare JOIN, funzioni analitiche e parametri di binding. Assegna un nome e salva. Qualsiasi elemento che puoi selezionare può diventare un endpoint.

3

Promuovilo e condividi una chiave

Apri la scheda Installa, scegli il tipo di endpoint (permanente, in scadenza o con budget di chiamate) e il formato di output, quindi invita un destinatario tramite e-mail. Riceveranno una richiesta di link magico e il proprio qsapi_* chiave.

Ideale per i dati di reporting di EBS ed EPM.

Se i tuoi report risiedono in uno schema Oracle E-Business Suite o EPM, una query salvata sulle viste appropriate diventa un endpoint pronto per i partner senza concedere a nessuno l'accesso all'applicazione. Puoi definire con precisione le colonne e le righe che i partner devono visualizzare e condividere solo quelle, non lo schema.

Nessun listener aperto, nessuna credenziale condivisa

Il modello di sicurezza è il motivo per cui i team scelgono questa soluzione anziché un listener pubblico o un livello ORDS self-hosted. La password dello schema Oracle risiede esclusivamente nell'archivio credenziali crittografato dell'agente sulla rete locale; non viene mai trasmessa al nostro cloud e non è mai visibile al destinatario. Inoltre, ogni endpoint offre controlli specifici per ciascun destinatario, che è possibile configurarli in modo più rigoroso prima della condivisione.

Agente solo in uscita

L'agente chiama a agent.querystreams.com sulla porta 443: nessuna porta in entrata, nessuna VPN, nessun tunnel. Come funziona la connessione solo in uscita →

Applicazione della sola lettura

Un validatore viene eseguito nell'Agent, sulla tua rete, prima che qualsiasi istruzione raggiunga Oracle. Le istruzioni non SELECT vengono rifiutate con VIOLAZIONE DI SOLA LETTURA.

Liste IP + CORS consentite

Associa la chiave di un destinatario a specifici indirizzi IP o intervalli CIDR e limita i browser che possono chiamare ciascun endpoint. Le chiamate provenienti da indirizzi esterni alla lista vengono rifiutate prima dell'esecuzione di qualsiasi query SQL.

Limiti di velocità + quote di byte

Due livelli di limiti di velocità (per chiave e per endpoint), più un limite mensile di byte opzionale, mantengono un destinatario rumoroso o fuori controllo entro un raggio di sicurezza.

Chiama la tua API REST Oracle

I destinatari chiamano l'endpoint come qualsiasi altra API REST: un token bearer e un URL. Qualsiasi parametro di query salvata esposto può essere impostato per chiamata — sulla stringa di query per OTTENERE o in un corpo JSON per INVIAREL'agente associa questi valori come variabili di associazione appropriate, mai come concatenazione di stringhe, in modo che un destinatario non possa aggirare un filtro per iniettare codice SQL.

GET con un parametro di filtro
# Chiamata del destinatario verso il tuo endpoint basato su Oracle arricciare -H “Autorizzazione: Portatore qsapi_K7…ZmQ” \ “https://api.querystreams.com/v1/endpoints/open-invoices?status=OPEN&since=2026-01-01”

Seleziona il formato di output per chiamata con il Accettare intestazione (o un ?format= parametro di query): JSON per un singolo array, CSV per fogli di calcolo e pandas, oppure, su un endpoint di streaming, NDJSON (una riga JSON per riga) per pipeline di analisi sintattica. Per i consumatori sensibili alla larghezza di banda, optare per LZ4 compressione del carico utile con Accept-Encoding: lz4; anche le risposte non compresse ottengono lo standard gzip sul filo automaticamente. Per la ripartizione completa delle modalità statica vs streaming, delle quattro combinazioni di fili e della generazione OpenAPI 3.1, vedere il API REST istantanea per database SQL guida.

Modalità di fatturazione dell'utilizzo

La piattaforma API fa parte di ogni piano e utilizza la stessa quota mensile di byte di Excel, Fogli Google e del server MCP. lz4 Le bollette delle chiamate vengono calcolate su byte compressi, altrimenti su byte non compressi. Come funziona la quota di byte condivisi →

Integralo in Power BI, Tableau e in qualsiasi programma che legga file JSON.

Poiché ogni endpoint restituisce standard JSON — grazie alla disponibilità di CSV e NDJSON in streaming — qualsiasi strumento in grado di leggere un feed REST può utilizzare direttamente i dati Oracle, senza bisogno di installare nulla e senza la necessità di un client Oracle. Power Query è il ponte più semplice per entrare nello stack di Business Intelligence di Microsoft: in Power BI scegliere Ottieni dati → Dal Web, incolla l'URL dell'endpoint, aggiungi il tuo Autorizzazione intestazione e Power Query analizza il JSON in una tabella aggiornabile che alimenta il modello di dati. (Per i dati in tempo reale all'interno di un foglio di calcolo, il nativo Componente aggiuntivo Query Streams per Excel è la strada più semplice: Power Query è disponibile quando si desidera accedere ai dati direttamente nel modello di Power BI.

Logo di Microsoft Power Query Power Query Ottieni dati → Dal Web, incolla l'URL e il token bearer, espandi il JSON in una tabella aggiornabile
Logo di Microsoft Power BI Power BI Stesso motore Power Query: carica l'endpoint direttamente nel tuo modello e pianifica l'aggiornamento.
Logo Tableau Tableau Punta un connettore dati Web o un'origine JSON all'endpoint per dashboard in tempo reale
logo del postino Postino Importa le specifiche OpenAPI 3.1, quindi invia, analizza e condividi le richieste con un solo clic.

Si nutre anche n8n, Qlik, arricciare, Python (richieste o pandas.read_json), Insomnia, Hoppscotch — o qualsiasi script o flusso di lavoro in grado di inviare una richiesta HTTP e leggere JSON.

Compatibile anche con Autonomo Database e Oracle gestito.

Non importa dove sia in esecuzione Oracle. L'agente si connette allo stesso modo a un database locale, a Oracle Real Application Clusters, a Oracle Autonomous Database su OCI o ad Amazon RDS per Oracle. Per ottenere la latenza più bassa, distribuisci l'agente nella stessa rete o regione del database; un singolo account Query Streams può eseguire più agenti in regioni e cloud diversi e un singolo endpoint si comporta in modo identico indipendentemente dall'agente che lo gestisce.

Più di Oracle

Lo stesso flusso di lavoro promuove una query salvata da PostgreSQL, Microsoft SQL Server, MySQL, MariaDB, SQLite, Microsoft Access, Snowflake, BigQuery o DuckDB a un endpoint REST. Oracle è semplicemente uno dei punti di partenza più popolari. Esplora il Guide all'installazione dei connettori per l'elenco attuale.

Domande frequenti

Devo installare ORDS o aprire una porta per esporre Oracle? +
No. Non si installa mai Oracle REST Data Services né si apre il 1521 In modalità listener, l'agente di rete stabilisce una connessione TLS in uscita e le richieste in entrata la percorrono nuovamente, eliminando così la necessità di un livello intermedio e di regole firewall in entrata. Il modello dell'agente solo in uscita nel dettaglio →
Il destinatario può visualizzare le mie credenziali SQL o del mio database? +
Mai. Il destinatario visualizza l'URL dell'endpoint, il corpo della risposta e gli eventuali parametri esposti come filtri. Il codice SQL rimane all'interno di Query Streams e la password dello schema Oracle risiede esclusivamente nell'archivio credenziali crittografato dell'agente sulla rete locale; non viene mai trasmessa al nostro cloud.
In che cosa si differenzia da Oracle REST Data Services (ORDS)? +
ORDS abilita le API REST per il tuo schema e funziona come un livello intermedio Java che puoi ospitare, proteggere, aggiornare e mantenere accessibile dal database. Query Streams adotta un approccio opposto, più specifico, per la condivisione in uscita: esponi una query salvata come un endpoint, ogni destinatario riceve la propria chiave revocabile, ogni chiamata viene registrata e non è necessario implementare nulla. Molti team utilizzano entrambi: ORDS per le applicazioni interne e Query Streams per la condivisione dei dati all'esterno.
Quali formati di output può restituire l'API? +
JSON (l'array predefinito), CSV e NDJSON sugli endpoint di streaming, scelti per ogni chiamata con il Accettare intestazione o ?format=, con compressione del carico utile LZ4 opzionale. Tutti i formati di bonifico e le relative modalità di fatturazione →
I destinatari possono filtrare i risultati o ricevono una query predefinita? +
Decidi tu: qualsiasi parametro che esponi nella query salvata diventa un filtro per chiamata (stringa di query su OTTENERE, corpo JSON su INVIARE), associato come variabile di bind in modo che i filtri non possano iniettare SQL. Come funzionano i parametri del filtro esposto →
Un endpoint può scadere o autodistruggersi? +
Sì, un endpoint può essere permanente, scadere in una data specifica o autodistruggersi dopo un determinato numero di chiamate, e la chiave di qualsiasi destinatario può essere revocata istantaneamente senza influire sulle altre o sulla modifica della password del database. Spiegazione del ciclo di vita dell'endpoint e della revoca delle chiavi →
È compatibile con Autonomous Database, RAC o Amazon RDS per Oracle? +
Sì. L'agente si connette a qualsiasi database Oracle raggiungibile: locale, Real Application Clusters, Oracle Autonomous Database su OCI o Amazon RDS per Oracle. Per ottenere la latenza migliore, esegui l'agente nella stessa rete o regione del database; un singolo account può eseguire più agenti in cloud e regioni diverse.
Il destinatario necessita di un account Query Streams? +
No — condividi con una persona via e-mail e un'organizzazione di livello gratuito viene creata automaticamente quando questa richiede il suo link magico o emette una chiave di servizio per l'accesso automatico da macchina a macchina. Rivendicazioni magic-link vs chiavi di servizio →

Iniziare

Pubblica gratuitamente la tua prima API REST Oracle.

Registrati, installa Network Agent accanto al tuo database Oracle, salva una query SQL e invia via email a un destinatario una richiesta di accesso tramite link magico. Chiavi per singolo destinatario, accesso in sola lettura e tracciabilità completa delle modifiche sono disponibili fin dalla prima chiamata.

Guide correlate: API REST istantanea per database SQL | Piattaforma API REST per database | Esporre PostgreSQL come API REST | Guide all'installazione dei connettori

Categoria: Piattaforma API

Tag: oracle-rest-api, oracle, oracle-database, ords-alternative, rest-api, Exposure-oracle-as-api, share-oracle-data, per-recipient-keys, no-code-api, database-rest-api

Meta Description: Trasforma una query Oracle in un'API REST sicura e di sola lettura con chiavi per destinatario: niente ORDS, niente listener aperti, niente codice.

Updated on 16 giugno 2026

Powered by BetterDocs