Daten mit der Get-API abrufen

Verwenden Sie die API GetRequest, um eine einzelne Datenzeile mit dem Primärschlüssel abzurufen.

Standardmäßig werden alle Lesevorgänge mit Eventualität konsistent ausgeführt. Dieser Lesetyp ist weniger kostspielig als die mit absoluter Konsistenz. Sie können die Standardkonsistenz für eine NoSQLHandle-Instanz mit der Methode setConsistency() in der Klasse Consistency ändern.

Die Klasse GetRequest bietet eine einfache und leistungsstarke Option zum Lesen von Daten, während Abfragen für komplexere Leseanforderungen verwendet werden können. Um Daten aus einer Tabelle zu lesen, geben Sie mit der Klasse GetRequest die Zieltabelle und den Zielschlüssel an, und verwenden Sie NoSQLHandle.get(), um die Anforderung auszuführen. Das Ergebnis des Vorgangs ist in GetResult verfügbar. Sie können die Konsistenz für eine NoSQLHandle-Instanz mit den Methoden NoSQLHandleConfig.setConsistency(oracle.nosql.driver.Consistency) und GetRequest.setConsistency() ändern.

Laden Sie den vollständigen Code QueryData.java aus den Beispielen hier herunter.
//Fetch single row using get API
private static void getRow(NoSQLHandle handle,String colName,int Id) throws Exception {
   MapValue key = new MapValue().put(colName, Id);
   GetRequest getRequest = new GetRequest().setKey(key)
                                        .setTableName(tableName);
   GetResult getRes = handle.get(getRequest);
   /* on success, GetResult.getValue() returns a non-null value */
   if (getRes.getValue() != null) {
      System.out.println("\t" +getRes.getValue().toString());
   } else {
      System.out.println("Get Failed");
   }
}

Hinweis:

Um Daten aus einer untergeordneten Tabelle abzurufen, geben Sie den vollständigen Namen der Tabelle (parent_tablename.child_tablename) in der Methode setTableName an. Laden Sie den vollständigen Code TableJoins.java aus den Beispielen herunter, um hier zu erfahren, wie Sie Daten aus einer Tabelle mit übergeordneten/untergeordneten Elementen abrufen.

Verwenden Sie die API GetRequest, um eine einzelne Datenzeile mit dem Primärschlüssel abzurufen. Sie können einzelne Zeilen mit der Methode borneo.NoSQLHandle.get() lesen. Mit dieser Methode können Sie einen Datensatz basierend auf seinem Primärschlüsselwert abrufen. Die Klasse borneo.GetRequest wird für einfache Abrufvorgänge verwendet. Er enthält den Primärschlüsselwert für die Zielzeile und gibt eine Instanz von borneo.GetResult zurück. Sie können die Standardkonsistenz für eine borneo.NoSQLHandle mit borneo.NoSQLHandleConfig.set_consistency() ändern, bevor Sie das Handle erstellen. Sie kann für eine einzelne Anforderung mit borneo.GetRequest.set_consistency() geändert werden.

Laden Sie den vollständigen Code QueryData.py aus den Beispielen hier herunter.
# Fetch single row using get API
def getRow(handle,colName,Id):
  request = GetRequest().set_table_name('stream_acct')
  request.set_key({colName: Id})
  print('Query results: ')
  result = handle.get(request)
  print('Query results are' + str(result.get_value()))

Hinweis:

Um Daten aus einer untergeordneten Tabelle abzurufen, geben Sie den vollständigen Namen der Tabelle (parent_tablename.child_tablename) in der Methode set_table_name an. Laden Sie den vollständigen Code TableJoins.py aus den Beispielen herunter, um zu erfahren, wie Sie Daten hier aus einer Tabelle mit übergeordneten/untergeordneten Elementen abrufen.

Verwenden Sie die API GetRequest, um eine einzelne Datenzeile mit dem Primärschlüssel abzurufen. Sie können einzelne Zeilen mit der Funktion Client.Get lesen. Mit dieser Funktion können Sie einen Datensatz basierend auf seinem Primärschlüsselwert abrufen. nosqldb.GetRequest wird für einfache Abrufvorgänge verwendet. Er enthält den Primärschlüsselwert für die Zielzeile und gibt eine Instanz von nosqldb.GetResult zurück. Wenn der get-Vorgang erfolgreich verläuft, wird eine Nicht-Nil-GetResult.Version zurückgegeben. Sie können die Standardkonsistenz für eine nosqldb.RequestConfig mit RequestConfig.Consistency ändern, bevor Sie den Client erstellen. Sie kann für eine einzelne Anforderung mit dem Feld GetRequest.Consistency geändert werden.

Laden Sie den vollständigen Code QueryData.go aus den Beispielen hier herunter.
//fetch data from the table
func getRow(client *nosqldb.Client, err error, tableName string, colName string, Id int)(){
	key:=&types.MapValue{}
   key.Put(colName, Id)
   req:=&nosqldb.GetRequest{
         TableName: tableName,
         Key: key,
   }
   res, err:=client.Get(req)
   if err != nil {
      fmt.Printf("GetResults() failed: %v\n", err)
      return
   }
   if res.RowExists() {
      fmt.Printf("Got row: %v\n", res.ValueAsJSON())
   } else {
      fmt.Printf("The row does not exist.\n")
   }
}

Hinweis:

Um Daten aus einer untergeordneten Tabelle abzurufen, geben Sie den vollständigen Namen der Tabelle (parent_tablename.child_tablename) im Parameter TableName an. Laden Sie den vollständigen Code TableJoins.go aus den Beispielen herunter, um hier zu erfahren, wie Sie Daten aus einer Tabelle mit übergeordneten/untergeordneten Elementen abrufen.

Verwenden Sie die API get, um eine einzelne Datenzeile mit dem Primärschlüssel abzurufen. Sie können eine einzelne Zeile mit der Methode get lesen. Mit dieser Methode können Sie einen Datensatz basierend auf seinem Primärschlüsselwert abrufen. Details zur Methode finden Sie in der Klasse NoSQLClient.

Legen Sie die Konsistenz des Lesevorgangs mit Consistency Enumeration fest. Sie können die Standardkonsistenz für Lesevorgänge in der anfänglichen Konfiguration festlegen, mit der eine NoSQLClient-Instanz mit der Konsistenzeigenschaft erstellt wird. Sie können ihn auch für einen einzelnen Lesevorgang ändern, indem Sie die Konsistenzeigenschaft im Argument GetOpt der get-Methode festlegen.

JavaScript: Laden Sie den vollständigen Code QueryData.js aus den Beispielen hier herunter.
//fetches single row with get API
async function getRow(handle,idVal) {
   try {
      const result = await handle.get(TABLE_NAME,{acct_Id: idVal });
      console.log('Got row:  %O', result.row);
   } catch(error) {
      console.error('  Error: ' + error.message);
   }
}
TypeScript: Sie können einen optionalen type-Parameter für eine Zeile auch für get und andere datenbezogene Methoden angeben. Mit dem type-Parameter kann der Compiler TypeScript type-Hints für die zurückgegebene GetResult-Methode bereitstellen sowie den übergebenen Schlüssel prüfen. Bei der Prüfung des Typs prüft der Compiler, ob das Primärschlüsselfeld Teil des Tabellenschemas ist und ob der Typ des Primärschlüsselfeldes einer der zulässigen Typen ist, d.h. entweder Zeichenfolge, numerisch, Datum oder boolescher Wert. Laden Sie den vollständigen Code QueryData.ts aus den Beispielen hier herunter.
interface StreamInt {
   acct_Id: Integer;
   profile_name: String;
   account_expiry: TIMESTAMP;
   acct_data: JSON;
}
/*fetches single row with get API*/
async function getRow(handle: NoSQLClient,idVal: Integer) {
   try {
      const result = await handle.get<StreamInt>(TABLE_NAME,{acct_Id: idVal });
      console.log('Got row:  %O', result.row);
   } catch(error) {
      console.error('  Error: ' + error.message);
   }
}

Hinweis:

Um Daten aus einer untergeordneten Tabelle abzurufen, geben Sie den vollständigen Namen der Tabelle (parent_tablename.child_tablename) im Parameter TABLE_NAME an. Laden Sie den vollständigen JavaScript-Code TableJoins.js hier und den vollständigen TypeScript-Code TableJoins.ts hier herunter, um zu erfahren, wie Sie Daten aus einer übergeordneten/untergeordneten Tabelle abrufen.

Mit der GET-API können Sie eine einzelne Datenzeile mit dem Primärschlüssel abrufen. Sie können eine einzelne Zeile mit der Methode GetAsync lesen. Mit dieser Methode können Sie eine Zeile basierend auf ihrem Primärschlüsselwert abrufen. Die Feldnamen müssen mit den Namen der Primärschlüsselspalte der Tabelle übereinstimmen. Sie können Optionen auch als GetOptions übergeben.

Sie können die Konsistenz eines Lesevorgangs mit Consistency Enumeration festlegen. Die Standardkonsistenz für Lesevorgänge kann als Konsistenzeigenschaft von NoSQLConfig festgelegt werden. Sie können die Konsistenz für einen einzelnen Get-Vorgang auch mit der Konsistenzeigenschaft GetOptions ändern. Die Methode GetAsync gibt Task<GetResult<RecordValue>> zurück. Die Instanz GetResult enthält die zurückgegebene Zeile, die Zeilenversion und andere Informationen. Wenn die Zeile mit dem angegebenen Primärschlüssel nicht in der Tabelle vorhanden ist, sind die Werte der Zeilen- und Versionseigenschaften Null.

Laden Sie den vollständigen Code QueryData.cs aus den Beispielen hier herunter.
private static async Task getRow(NoSQLClient client,String colName, int Id){
   var result = await client.GetAsync(TableName,
         new MapValue
         {
             [colName] =Id
         });
   if (result.Row != null){
      Console.WriteLine("Got row: {0}\n", result.Row.ToJsonString());
   }
   else {
      Console.WriteLine("Row with primaryKey {0} doesn't exist",colName);
   }
}

Hinweis:

Um Daten aus einer untergeordneten Tabelle abzurufen, geben Sie den vollständigen Namen der Tabelle (parent_tablename.child_tablename) im Parameter TableName an. Laden Sie den vollständigen Code TableJoins.cs aus den Beispielen herunter, um hier zu erfahren, wie Sie Daten aus einer Tabelle mit übergeordneten/untergeordneten Elementen abrufen.

Verwandte Themen