Documentazione dell'infrastruttura Oracle Cloud

Accesso ai dati con collegamenti ipertestuali tabella o con un gruppo collegamenti ipertestuali tabella

I dati del collegamento ipertestuale tabella vengono recuperati e restituiti in formato JSON ed è impaginato.

È possibile accedere ai dati dei collegamenti ipertestuali delle tabelle utilizzando un browser o qualsiasi client REST. I dati restituiti vengono impaginati per consentire l'accesso a un massimo di 100 record alla volta, con la dimensione totale dei dati nella risposta limitata a 1 MB. È possibile fornire il parametro di query limit per limitare il numero di record recuperati. Il recupero dei dati del collegamento ipertestuale tabella è bloccato se l'autenticazione del collegamento ipertestuale tabella non riesce o se il collegamento ipertestuale tabella richiesto è scaduto.

Quando si crea un collegamento ipertestuale tabella o un gruppo di collegamenti ipertestuali tabella, è possibile impostare il parametro consistent per specificare che il producer fornisce i dati in modo coerente su pagine diverse quando un consumer accede ai dati. Quando consistent è impostato su TRUE, il producer fornisce dati coerenti a un consumer che accede a più pagine di dati. Ciò significa che il primo accesso di un consumatore e le successive richieste di dati per le pagine associate a un collegamento ipertestuale tabella utilizzano lo stesso snapshot di dati (SCN) della richiesta per la prima pagina.

Nota

I dati del collegamento ipertestuale tabella possono essere visualizzati in formato tabulare quando si accede da un browser. Per informazioni dettagliate, vedere Accedere ai dati in formato tabella con collegamenti ipertestuali di tabella o gruppi di collegamenti ipertestuali di tabella.

Argomento padre: Utilizzare i collegamenti ipertestuali delle tabelle per l'accesso AI dati di sola lettura in Autonomous AI Database

Usa collegamento ipertestuale tabella per accedere ai dati

I dati del collegamento ipertestuale tabella vengono recuperati e restituiti in formato JSON ed è impaginato.

Ad esempio, per utilizzare un collegamento ipertestuale tabella ed elaborare la risposta:

curl https://dataaccess.adb.us-chicago-1.oraclecloudapps.com/adb/p/K6XExample/data

La risposta Collegamento ipertestuale tabella include collegamenti per qualsiasi pagina precedente o successiva, quando i dati includono più pagine. Ciò consente di spostarsi in entrambe le direzioni durante il recupero dei dati. Il file JSON include anche un collegamento self che punta alla pagina corrente, nonché un attributo hasMore che indica se sono disponibili altri dati da recuperare.

Di seguito è riportato il formato di risposta.

{
    "items": [],                 <-- Array of records from database
    "hasMore": true OR false,    <-- Indicates if there are more records to fetch or not
    "limit": Number,             <-- Indicates number of records in the page. Maximum allowed number is 100.
    "offset": Number,            <-- Offset indicating the start of the current page
    "count": Number,             <-- Count of records in the current page
    "links": [
        {
            "rel": "self",
            "href": "{Link to table hyperlink url for the current page}"
        },
        {
            "rel": "previous",
            "href": "{Link to table hyperlink url for the previous page}"
        },
        {
            "rel": "next",
            "href": "{Link to table hyperlink url for the next page}"
        }
    ]
}

Ad esempio, di seguito è riportata una risposta di esempio da un collegamento ipertestuale tabella (con nuove righe aggiunte per maggiore chiarezza):

{"items":[
{"COUNTY":"Main","SPECIES":"Alder","HEIGHT":45},
{"COUNTY":"First","SPECIES":"Chestnut","HEIGHT":51},{"COUNTY":"Main","SPECIES":"Hemlock","HEIGHT":17},
{"COUNTY":"Main","SPECIES":"Douglas-fir","HEIGHT":34},{"COUNTY":"First","SPECIES":"Larch","HEIGHT":12},
{"COUNTY":"Main","SPECIES":"Cedar","HEIGHT":21},{"COUNTY":"First","SPECIES":"Douglas-fir","HEIGHT":10},
{"COUNTY":"Main","SPECIES":"Yew","HEIGHT":11},{"COUNTY":"First","SPECIES":"Willow","HEIGHT":17},
{"COUNTY":"Main","SPECIES":"Pine","HEIGHT":29},{"COUNTY":"First","SPECIES":"Pine","HEIGHT":16},
{"COUNTY":"First","SPECIES":"Spruce","HEIGHT":6},{"COUNTY":"Main","SPECIES":"Spruce","HEIGHT":8},
{"COUNTY":"First","SPECIES":"Hawthorn","HEIGHT":19},{"COUNTY":"First","SPECIES":"Maple","HEIGHT":16},
{"COUNTY":"Main","SPECIES":"Aspen","HEIGHT":35},{"COUNTY":"First","SPECIES":"Larch","HEIGHT":27},
{"COUNTY":"First","SPECIES":"Cherry","HEIGHT":20},{"COUNTY":"Main","SPECIES":"Pine","HEIGHT":37},
{"COUNTY":"Main","SPECIES":"Redwood","HEIGHT":78},{"COUNTY":"Main","SPECIES":"Alder","HEIGHT":45},
{"COUNTY":"First","SPECIES":"Chestnut","HEIGHT":51},{"COUNTY":"Main","SPECIES":"Hemlock","HEIGHT":17},
{"COUNTY":"Main","SPECIES":"Douglas-fir","HEIGHT":34},{"COUNTY":"First","SPECIES":"Larch","HEIGHT":12},
{"COUNTY":"Main","SPECIES":"Cedar","HEIGHT":21},{"COUNTY":"First","SPECIES":"Douglas-fir","HEIGHT":10},
{"COUNTY":"Main","SPECIES":"Redwood","HEIGHT":78}],

"hasMore":false,
"limit":100,
"offset":0,
"count":30,
"links":
[
{"rel":"self",
"href":"https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/F5Sn..._example/data"}
]}

Usa collegamento ipertestuale tabella per accedere ai dati con variabili di binding

Se nell'istruzione SELECT è presente una bind variable quando si genera un collegamento ipertestuale tabella, è necessario utilizzare il parametro default_bind_values quando si genera il collegamento ipertestuale tabella per specificare un valore di bind variable predefinito oppure passare un valore di bind variable come parametro di query per accedere ai dati del collegamento ipertestuale tabella.

Il supporto delle variabili di binding è disponibile per i tipi di colonna NUMBER e VARCHAR2.

Ad esempio, quando viene generato un collegamento ipertestuale tabella con la seguente istruzione SQL e non si specifica il parametro default_bind_values: 

sql_statement = 'SELECT * FROM TREE_DATA WHERE COUNTY = :countyName'

È necessario aggiungere una bind variable e specificare un valore come parametro di query per accedere ai dati. Ad esempio:

curl https://dataaccess.adb.us-chicago-1.oraclecloudapps.com/adb/p/K6X...example/data?countyNAME=MAIN

Non è necessario specificare il valore di bind nell'URL quando DBMS_DATA_ACCESS.CREATE_URL include il parametro default_bind_values:

Ad esempio, con i seguenti parametri in DBMS_DATA_ACCESS.CREATE_URL: 

sql_statement = 'SELECT * FROM TREE_DATA WHERE COUNTY = :countyNAME',
default_bind_values => '{"countyNAME" : "First"}'

In questo caso il parametro default_bind_values definisce il valore per la bind variable e non è necessario fornire il valore come parametro di query (viene fornito il valore predefinito): 

curl https://dataaccess.adb.us-chicago-1.oraclecloudapps.com/adb/p/K6X...example/data

{"items":[
{"COUNTY":"First","SPECIES":"Pine","HEIGHT":16},
{"COUNTY":"First","SPECIES":"Spruce","HEIGHT":6},
{"COUNTY":"First","SPECIES":"Hawthorn","HEIGHT":19},
{"COUNTY":"First","SPECIES":"Cherry","HEIGHT":20},
{"COUNTY":"First","SPECIES":"Chestnut","HEIGHT":51}],
"hasMore":false,
"limit":100,
"offset":0,
"count":6,
"links":
[
{"rel":"self",
"href":"https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/gTlbq...example/data"}
]}

Quando default_bind_values definisce un valore di bind variable, è possibile sostituire il valore di bind variable specificando in modo esplicito un valore come parametro di query. Ad esempio: 

curl https://dataaccess.adb.us-chicago-1.oraclecloudapps.com/adb/p/K6X...example/data?countyNAME=MAIN

Per ulteriori informazioni, vedere CREATE_URL Procedure.

Accesso ai dati per un collegamento ipertestuale tabella protetta da password

Quando si include il parametro password con DBMS_DATA_ACCESS.CREATE_URL per creare un collegamento ipertestuale tabella protetto da password, insieme al valore URL, i producer devono condividere la password con i consumer. I consumer utilizzano sia l'URL che la password per accedere ai dati e forniscono la password per accedere ai dati utilizzando l'autenticazione di base su REST.

Ad esempio:

HEADER
Authorization: Basic password
GET https://dataaccess.adb.us-ashburn-1.oraclecloudapps.com/adb/p/Vdtv..._example_wxd0PN/data

Utilizzare un gruppo di collegamenti ipertestuali tabella per accedere ai dati

I dati del gruppo di collegamenti ipertestuali tabella vengono recuperati e restituiti in formato JSON ed è impaginato.

Ad esempio, per utilizzare un gruppo di collegamenti ipertestuali tabella ed elaborare la risposta:

curl https://dataaccess.adb.us-chicago-1.oraclecloudapps.com/adb/p/K6XExample/data

La risposta Gruppo collegamenti ipertestuali tabella include le informazioni sull'URL del membro.

Di seguito è riportata, ad esempio, una risposta di esempio per un gruppo di collegamenti ipertestuali tabella.

{  "member_urls": [
    {      
      "id": "{member_id}",
      "name": "{member_name}",
      "description": "{member_description}" 
    },
    .....
    ]
}

È possibile utilizzare la seguente API REST per accedere ai dati di un membro del gruppo di collegamenti ipertestuali tabella utilizzando uno dei valori member_id forniti. Ad esempio: 

Get https://dataaccess.adb.{region_name}.oraclecloudapps.com/adb/p/{group_par_url_token}/data?member_id={member_id}
 
Response
200 OK - Success
 
{
    "items": [],                 <-- Array of records from database
    "hasMore": true OR false,    <-- Indicates if there are more records to fetch or not
    "limit": Number,             <-- Indicates number of records in the page. Maximum allowed number is 100.
    "offset": Number,            <-- Offset indicating the start of the current page
    "count": Number,             <-- Count of records in the current page
    "links": [
        {
            "rel": "self",
            "href": "{Link to Table Hyperlink for the current page}"
        },
        {
            "rel": "previous",
            "href": "{Link to Table Hyperlink for the previous page}"
        },
        {
            "rel": "next",
            "href": "{Link to Table Hyperlink for the next page}"
        }
    ]
}