Documentazione dell'infrastruttura Oracle Cloud

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

I dati del collegamento ipertestuale della tabella vengono recuperati e restituiti in formato JSON e vengono impaginati.

È possibile accedere ai dati del collegamento ipertestuale della tabella utilizzando un browser o qualsiasi client REST. I dati restituiti vengono impaginati per consentire di accedere 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 viene bloccato se l'autenticazione del collegamento ipertestuale tabella non riesce o se il collegamento ipertestuale tabella richiesto è scaduto.

Nota

I dati dei collegamenti ipertestuali delle tabelle possono essere visualizzati in formato tabulare quando si accede da un browser. Per ulteriori informazioni, vedere Usa collegamenti ipertestuali tabella per accedere ai dati in formato tabella.

Argomento padre: usare i collegamenti ipertestuali delle tabelle per l'accesso ai dati di sola lettura su Autonomous 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 ulteriori dati da recuperare.

Di seguito è riportato il formato della 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 di 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 senza 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: 

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

Nel caso in cui default_bind_values definisca un valore per una variabile, 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.

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}"
        }
    ]
}