エクスポート (0) 印刷
すべて展開

table オブジェクト

更新日: 2013年1月

特定のテーブルを操作するための機能を提供します。

このオブジェクトには、次のメンバーがあります。

del

指定したアイテムをテーブルから削除します。

構文

Table.del(itemOrId, options)

パラメーター

 

パラメーター 説明

itemID

指定した ID を持つアイテムまたは行。

戻り値

未定義です。

 

構文 戻り値 説明

del

 

未定義

 

insert

Table.insert(item, options)

未定義

指定した item を指定した tableName に挿入します。

orderBy

Table.orderBy(arg1, arg2, …)

query オブジェクト

指定した列名引数に基づいてクエリを昇順で並べ替えた Query オブジェクト インスタンスを返します。

orderByDescending

Table.orderByDescending(arg1, arg2, …)

query オブジェクト

指定した列名引数に基づいてクエリを降順で並べ替えた Query オブジェクト インスタンスを返します。

read

Table.read(options)

未定義

テーブルからすべてのデータを読み取り、結果の配列を渡す options パラメーターで指定した成功ハンドラーを呼び出します。

Important重要
サイズが無制限のテーブルに対して read メソッドを呼び出さないでください。

select

Table.select(string)

query オブジェクト

要求された string プロジェクションを適用した Query オブジェクト インスタンスを返します。

Table.select(function)

query オブジェクト

要求された function プロジェクションを適用した Query オブジェクト インスタンスを返します。

skip

Table.skip(recordCount)

query オブジェクト

最初の recordCount 個のレコードをスキップした Query オブジェクト インスタンスを返します。

take

Table.take(recordCount)

query オブジェクト

recordCount 個のレコードを返す Query オブジェクト インスタンスを返します。

where

Table.where(object)

query オブジェクト

指定した JSON object のプロパティ値に基づいてフィルター選択された Query オブジェクト インスタンスを返します。

Table.where(function)

query オブジェクト

指定した function に基づいてフィルター選択された Query オブジェクト インスタンスを返します。

update

Table.update(item, options)

未定義

指定した item を指定した tableName に更新します。

insertupdate、および del メソッドは、成功ハンドラーまたはエラー ハンドラーを定義できる options オブジェクトを受け取ります。

Query のメソッド (orderByorderByDescendingselectskiptake、および where) はすべて Query オブジェクトを返します。このオブジェクトでは、同じメソッドを公開しています。このオブジェクトを使用して、クエリを一連のメソッド呼び出しとして構成できます。

次のスクリプトでは、where メソッドを呼び出して、指定したオブジェクト値で返される行をフィルター選択します。1 つ以上のレコードが返された場合は、ユーザーが注文を送信するために必要な権限を持っており、挿入が実行されたと見なされます。それ以外の場合は、エラーが返されます。

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.');
            }
        }
    });
}

次の関数では、スケジュールされたジョブから、重複する行を返し、del メソッドを使用して、重複する行を削除する Transact-SQL を実行します。

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.');
            }
        }
    });
}

表示:
© 2014 Microsoft