Экспорт (0) Печать
Развернуть все

Объект table

Обновлено: Февраль 2015 г.

Предоставляет функции для работы с конкретными таблицами.

del(itemOrId, options)
Удаляет указанный itemID из таблицы.

Параметры

Название Тип Аргумент Описание

itemOrId

объект

элемент, который нужно удалить

параметры

параметр обратного вызова

insert(item, options)
Вставляет указанный item в таблицу.

Параметры

Название Тип Аргумент Описание

item

объект

элемент, который нужно вставить

параметры

параметр обратного вызова

orderBy(arg1, arg2, …)
Возвращает экземпляр объекта запроса, где запрос упорядочен по предоставленным аргументам имени столбца в порядке возрастания.

Параметры

Название Тип Аргумент Описание

Arg1

строка

Основной столбец, по которому выполняется сортировка

Arg2

строка

необязательно, так как существуют дополнительные имена столбцов

Следующий столбец, по которому выполняется сортировка

orderByDescending(arg1, arg2, …)
Возвращает экземпляр объекта запроса, где запрос упорядочен по предоставленным аргументам имени столбца в порядке убывания.

Параметры

Название Тип Аргумент Описание

Arg1

строка

Основной столбец, по которому выполняется сортировка

Arg2

строка

необязательно, так как существуют дополнительные имена столбцов

Следующий столбец, по которому выполняется сортировка

Чтение (параметры)
Считывает все данные из таблицы и вызывает успешный обработчик, указанный в параметре options, передавая массив результатов.

ImportantВажно!
Не следует вызывать метод read для таблиц неограниченного размера.

Параметры

Название Тип Аргумент Описание

параметры

параметр обратного вызова

select(string)
Возвращает экземпляр объекта запроса с примененной запрошенной проекцией string.

Параметры

Название Тип Аргумент Описание

строка

список строк, разделенный запятыми

имена столбцов, которые нужно вернуть, заключенные в одинарные кавычки, разделенные запятыми

select(function)
Возвращает экземпляр объекта запроса с примененной запрошенной проекцией string.

Параметры

Название Тип Аргумент Описание

функция

функция

Возвращает экземпляр объекта запроса с примененной запрошенной проекцией function. В определении функции ключевое слово this обращается к строке, а оператор точки обращается к столбцу. К ним можно применить функции JavaScript.

skip(recordCount)
Возвращает экземпляр объекта запроса с пропуском первых recordCount записей.

Параметры

Название Тип Аргумент Описание

recordCount

целое число

Количество записей, которые будут пропущены

take(recordCount)
Возвращает экземпляр объекта запроса, который возвращает recordCount записей.

Параметры

Название Тип Аргумент Описание

recordCount

целое число

Количество возвращаемых записей

where(object)
Возвращает экземпляр объекта запроса, фильтрованный по значениям свойств предоставленного JSON object.

Параметры

Название Тип Аргумент Описание

Объект

объект

Объект JSON со значениями свойств, по которым нужно выполнить фильтрацию

where(function)
Возвращает экземпляр объекта запроса, отфильтрованный по предоставленной функции.

Параметры

Название Тип Аргумент Описание

функция

функция

Возвращает экземпляр объекта запроса с примененным запрошенным фильтром function. В определении функции ключевое слово this обращается к строке, а оператор точки обращается к столбцу. К ним можно применить функции JavaScript.

update(item, options)
Вставляет указанный item в таблицу.

Параметры

Название Тип Аргумент Описание

item

объект

элемент, который нужно вставить

параметры

функция обратного вызова

Методы insert, update и del принимают объект options, в котором могут быть определены успешные обработчики и обработчики, возвращающие ошибку.

Методы запроса (orderBy, orderByDescending, select, skip, take и where) возвращают объект запроса. Этот объект предоставляет те же методы и позволяет составлять запросы как ряд вызовов методов.

Ниже приведен ряд примеров.

  1. Запрос проекции, который возвращает выбранные столбцы

  2. Фильтр where

  3. Код TSQL с фильтрами

Этот скрипт демонстрирует выполнение запроса проекции, который возвращает только выбранные столбцы. Параметр read показывает, каким образом закодирован параметр options.

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

Следующий скрипт вызывает метод where для фильтрации возвращаемых строк по предоставленным значениям объекта. Если по крайней мере одна запись возвращена, предполагается, что у пользователя есть необходимое разрешение для отправки указания, и вставка выполняется; в противном случае возвращается ошибка.

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

В этом примере показано, как вызвать select с параметром function.

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

Следующая функция из запланированного задания выполняет Transact-SQL, которая возвращает одинаковые строки и затем использует метод del для удаления повторяющихся значений.

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

Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2015 Microsoft