Oracle Cloud Infrastructure-Dokumentation

Auf Daten mit Tabellen-Hyperlinks oder mit Tabellen-Hyperlink-Gruppe zugreifen

Tabellen-Hyperlink-Daten werden im JSON-Format abgerufen und zurückgegeben und sind paginiert.

Sie können über einen Browser oder einen beliebigen REST-Client auf Tabellen-Hyperlink-Daten zugreifen. Die zurückgegebenen Daten werden paginiert, damit Sie auf maximal 100 Datensätze gleichzeitig zugreifen können. Die Gesamtdatengröße in der Antwort ist auf 1 MB begrenzt. Sie können den Abfrageparameter limit angeben, um die Anzahl der abgerufenen Datensätze zu begrenzen. Der Abruf von Tabellen-Hyperlink-Daten wird blockiert, wenn die Authentifizierung des Tabellen-Hyperlinks fehlschlägt oder der angeforderte Tabellen-Hyperlink abgelaufen ist.

Hinweis

Tabellen-Hyperlink-Daten können tabellarisch angezeigt werden, wenn Sie von einem Browser aus darauf zugreifen. Weitere Informationen finden Sie unter Tabellenhyperlinks für den Zugriff auf Daten im Tabellenformat verwenden.

Übergeordnetes Thema: Tabellenhyperlinks für schreibgeschützten Datenzugriff in Autonomous Database verwenden

Tabellen-Hyperlink für den Zugriff auf Daten verwenden

Tabellen-Hyperlink-Daten werden im JSON-Format abgerufen und zurückgegeben und sind paginiert.

Beispiel: So verwenden Sie einen Tabellen-Hyperlink und verarbeiten die Antwort:

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

Die Antwort auf den Tabellen-Hyperlink enthält Links für vorherige oder nächste Seiten, wenn die Daten mehrere Seiten enthalten. Dadurch können Sie beim Abrufen von Daten in beide Richtungen navigieren. Die JSON enthält auch einen self-Link, der auf die aktuelle Seite verweist, sowie ein hasMore-Attribut, das angibt, ob weitere Daten zum Abrufen verfügbar sind.

Das Antwortformat lautet:

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

Beispiel: Das Folgende ist eine Beispielantwort eines Tabellen-Hyperlinks (mit neuen Zeilen zur Klarheit hinzugefügt):

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

Tabellen-Hyperlink für den Zugriff auf Daten mit Bind-Variablen verwenden

Wenn eine Bind-Variable in der SELECT-Anweisung beim Generieren eines Tabellen-Hyperlinks vorhanden ist, müssen Sie entweder den Parameter default_bind_values verwenden, wenn Sie den Tabellen-Hyperlink generieren, um einen Standard-Bind-Variablenwert anzugeben, oder Sie müssen einen Bind-Variablenwert als Abfrageparameter übergeben, um auf die Tabellen-Hyperlink-Daten zuzugreifen.

Die Unterstützung von Bind-Variablen ist für die Spaltentypen NUMBER und VARCHAR2 verfügbar.

Beispiel: Wenn ein Tabellen-Hyperlink mit der folgenden SQL-Anweisung ohne den Parameter default_bind_values generiert wird: 

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

Sie müssen eine Bind-Variable anhängen und einen Wert als Abfrageparameter angeben, um auf die Daten zuzugreifen. Beispiel:

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

Der Bind-Wert muss nicht in der URL angegeben werden, wenn DBMS_DATA_ACCESS.CREATE_URL den Parameter default_bind_values enthält: 

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

Wenn default_bind_values einen Wert für eine Variable definiert, müssen Sie den Wert nicht als Abfrageparameter angeben (der Standardwert wird angegeben): 

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

Wenn default_bind_values einen Bind-Variablenwert definiert, können Sie den Bind-Variablenwert außer Kraft setzen, indem Sie explizit einen Wert als Abfrageparameter angeben. Beispiel: 

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

Weitere Informationen finden Sie unter Prozedur CREATE_URL.

Tabellen-Hyperlink-Gruppe für den Zugriff auf Daten verwenden

Tabellen-Hyperlinkgruppendaten werden abgerufen und im JSON-Format zurückgegeben und sind paginiert.

Beispiel: So verwenden Sie eine Tabellen-Hyperlink-Gruppe und verarbeiten die Antwort:

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

Die Antwort der Tabellen-Hyperlinkgruppe enthält die Element-URL-Informationen.

Beispiel für eine Tabellen-Hyperlink-Gruppe:

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

Als Nächstes können Sie mit der folgenden REST-API auf die Daten für ein Element der Tabellen-Hyperlinkgruppe zugreifen. Verwenden Sie dazu einen der angegebenen member_id-Werte. Beispiel: 

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