VERTRIEB: 1-800-867-1380

table-Objekt

Letzte Aktualisierung: Juni 2015

Stellt Funktionen zum Arbeiten mit bestimmten Tabellen bereit.

del(itemOrId, options)
Löscht eine angegebene itemID aus der Tabelle.

Parameter

Name Typ Argument Beschreibung

itemOrId

object

Das zu löschende Element.

Optionen

Rückrufparameter

insert(item, options)
Fügt das angegebene item in die Tabelle ein.

Parameter

Name Typ Argument Beschreibung

item

object

Das einzufügende Element.

Optionen

Rückrufparameter

orderBy(arg1, arg2, …)
Gibt eine Query-Objekt-Instanz zurück, bei der die Abfrage anhand der angegebenen Spaltennamenargumente in aufsteigender Reihenfolge sortiert ist.

Parameter

Name Typ Argument Beschreibung

Arg1

Zeichenfolge

Die Hauptspalte, nach der sortiert wird.

Arg2

Zeichenfolge

Optional, wenn mehr Spaltennamen vorhanden sind.

Die nächste Spalte, nach der sortiert wird.

orderByDescending(arg1, arg2, …)
Gibt eine Query-Objekt-Instanz zurück, bei der die Abfrage anhand der angegebenen Spaltennamenargumente in absteigender Reihenfolge sortiert ist.

Parameter

Name Typ Argument Beschreibung

Arg1

Zeichenfolge

Die Hauptspalte, nach der sortiert wird.

Arg2

Zeichenfolge

Optional, wenn mehr Spaltennamen vorhanden sind.

Die nächste Spalte, nach der sortiert wird.

Read (options)
Liest alle Daten aus der Tabelle und ruft den Erfolgshandler auf, der im Parameter options angegeben ist, der ein Array von Ergebnissen übergibt.

ImportantWichtig
Die Methode read sollte nicht für Tabellen mit unbegrenzter Größe aufgerufen werden.

Parameter

Name Typ Argument Beschreibung

Optionen

Rückrufparameter

select(string)
Gibt eine Query-Objekt-Instanz zurück, auf die die angeforderte string-Projektion angewendet wurde.

Parameter

Name Typ Argument Beschreibung

Zeichenfolge

Durch Trennzeichen getrennte Liste mit Zeichenfolgen.

Zurückzugebende Spaltennamen, in einfache Anführungszeichen eingeschlossen, durch Kommas getrennt.

select(function)
Gibt eine Query-Objekt-Instanz zurück, auf die die angeforderte string-Projektion angewendet wurde.

Parameter

Name Typ Argument Beschreibung

Funktion

function

Gibt eine Query-Objekt-Instanz zurück, auf die die angeforderte function-Projektion angewendet wurde. In der Funktionsdefinition greift das this-Schlüsselwort greift auf eine Zeile zu, und der Punktoperator greift auf eine Spalte zu, außerdem können JavaScript-Funktionen darauf angewendet werden.

skip(recordCount)
Gibt eine Query-Objekt-Instanz zurück, die die ersten recordCount Datensätze überspringt.

Parameter

Name Typ Argument Beschreibung

recordCount

integer

Die Anzahl der zu überspringenden Datensätze.

take(recordCount)
Gibt eine Query-Objekt-Instanz zurück, die recordCount Datensätze zurückgibt.

Parameter

Name Typ Argument Beschreibung

recordCount

integer

Die Anzahl der zurückzugebenden Datensätze.

where(object)
Gibt eine Query-Objekt-Instanz zurück, die anhand der Eigenschaftswerte des angegebenen JSON-object gefiltert wird.

Parameter

Name Typ Argument Beschreibung

Objekt

object

Ein JSON-Objekt mit Eigenschaftswerten, nach denen gefiltert werden kann.

where(function)
Gibt eine Query-Objekt-Instanz zurück, die anhand der angegebenen Funktion (function) gefiltert wird.

Parameter

Name Typ Argument Beschreibung

Funktion

function

Gibt eine Query-Objekt-Instanz zurück, auf die der angeforderte function-Filter angewendet wurde. In der Funktionsdefinition greift das this-Schlüsselwort greift auf eine Zeile zu, und der Punktoperator greift auf eine Spalte zu, außerdem können JavaScript-Funktionen darauf angewendet werden.

update(item, options)
Fügt das angegebene item in die Tabelle ein.

Parameter

Name Typ Argument Beschreibung

item

object

Das einzufügende Element.

Optionen

Rückruffunktion

Die Methoden insert, update und del akzeptieren ein options-Objekt, für das Erfolgs- oder Fehlerhandler definiert sein können.

Alle Abfragemethoden (orderBy, orderByDescending, select, skip, take und where) geben ein Query-Objekt zurück. Dieses Objekt macht die gleichen Methoden verfügbar, sodass Sie Abfragen als eine Reihe von Methodenaufrufen zusammenstellen können.

Im Folgenden finden Sie einige Beispiele:

  1. Projektionsabfrage, die ausgewählte Spalten zurückgibt.

  2. Where-Filter

  3. TSQL-Code mit Filtern

Dieses Skript zeigt, wie eine Projektionsabfrage ausgeführt wird, die nur ausgewählte Spalten zurückgibt. Der read-Parameter zeigt, wie der options-Parameter codiert ist.

    var tableName = tables.getTable("TodoItem");
    console.log("table name is " + tableName);
    tableName.select('text', 'complete')
        .read(
            { success: function(results) {
                if (results.length > 0) {
                    console.log(results);
                } else {
                    console.log('no results returned');
                }
            }
        });;

Das folgende Skript ruft die where-Methode auf, um die zurückgegebenen Zeilen anhand der angegebenen Objektwerte zu filtern. Wenn mindestens ein Datensatz zurückgegeben wird, wird davon ausgegangen, dass der Benutzer über die erforderliche Berechtigung verfügt, um einen Auftrag zu senden, und die Einfügung wird ausgeführt; andernfalls wird ein Fehler zurückgegeben.

function insert(item, user, request) {
    var permissionsTable = tables.getTable('permissions');

    permissionsTable.where({
        userId: user.userId,
        permission: 'submit order'
    }).read({
        success: function(results) {
            if (results.length > 0) {
                // Permission record was found. Continue normal execution.
                request.execute();
            } else {
                console.log('User %s attempted to submit an order without permissions.', user.userId);
                request.respond(statusCodes.FORBIDDEN, 'You do not have permission to submit orders.');
            }
        }
    });
}

Dieses Beispiel zeigt, wie ein select mit einem Funktionsparameter aufgerufen wird.

    tableName.select(function() { return this.id.substring(2,5) })
    .read(
        { success: function(results) { 
                if (results.length > 0) {
                    console.log(results);
                } else {
                    console.log('no results returned');
                }
            }});

Die folgende Funktion aus einem geplanten Auftrag, führt Transact-SQL aus, das doppelte Zeilen zurückgibt und dann die del-Methode verwendet, um die Duplikate zu entfernen.

function cleanup_channels() {
    var sql = "SELECT MAX(Id) as Id, Uri FROM Channel " + 
        "GROUP BY Uri HAVING COUNT(*) > 1";
    var channelTable = tables.getTable('Channel');

    mssql.query(sql, {
        success: function(results) {
            if (results.length > 0) {
                for (var i = 0; i < results.length; i++) {
                    channelTable.del(results[i].Id);
                    console.log('Deleted duplicate channel:' + 
                    results[i].Uri);
                }
            } else {
                console.log('No duplicate rows found.');
            }
        }
    });
}

Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.
Anzeigen:
© 2015 Microsoft