이 페이지가 유용했습니까?
이 콘텐츠에 대한 여러분의 의견은 중요합니다. 의견을 알려주십시오.
추가 의견
1500자 남음
내보내기(0) 인쇄
모두 확장

table 개체

업데이트 날짜: 2015년 6월

특정 테이블 작업에 대한 기능을 제공합니다.

del(itemOrId, options)
테이블에서 지정된 itemID를 삭제합니다.

매개 변수

Name Type 인수 설명

itemOrId

개체

삭제할 항목입니다.

옵션

콜백 매개 변수입니다.

insert(item, options)
지정된 item을 테이블에 삽입합니다.

매개 변수

Name Type 인수 설명

item

개체

삽입할 항목입니다

옵션

콜백 매개 변수입니다.

orderBy(arg1, arg2, …)
제공된 열 이름 인수별로 쿼리가 오름차순으로 정렬되는 Query 개체 인스턴스를 반환합니다.

매개 변수

Name Type 인수 설명

Arg1

문자열

정렬 기준으로 사용할 주요 열입니다.

Arg2

문자열

선택 사항(추가 열 이름)

정렬 기준으로 사용할 다음 열입니다.

orderByDescending(arg1, arg2, …)
제공된 열 이름 인수별로 쿼리가 내림차순으로 정렬되는 Query 개체 인스턴스를 반환합니다.

매개 변수

Name Type 인수 설명

Arg1

문자열

정렬 기준으로 사용할 주요 열입니다.

Arg2

문자열

선택 사항(추가 열 이름)

정렬 기준으로 사용할 다음 열입니다.

Read(options)
테이블에서 모든 데이터를 읽고 결과 배열을 전달하는 options 매개 변수에 지정된 성공 처리기를 호출합니다.

Important중요
제한 없는 크기의 태블릿에서 read 메서드를 호출하면 안 됩니다.

매개 변수

Name Type 인수 설명

옵션

콜백 매개 변수입니다.

select(string)
요청한 string 프로젝션이 적용된 Query 개체 인스턴스를 반환합니다.

매개 변수

Name Type 인수 설명

문자열

쉼표로 구분된 문자열 목록

작은따옴표로 묶이며 쉼표로 구분되는 반환할 열 이름입니다.

select(function)
요청한 string 프로젝션이 적용된 Query 개체 인스턴스를 반환합니다.

매개 변수

Name Type 인수 설명

function

함수

요청한 function 프로젝션이 적용된 Query 개체 인스턴스를 반환합니다. 함수 정의에서 this 키워드는 행에 액세스하고 점 연산자는 열에 액세스합니다. 이러한 항목에 JavaScript 함수를 적용할 수 있습니다.

skip(recordCount)
처음 recordCount개의 레코드를 건너뛰는 Query 개체 인스턴스를 반환합니다.

매개 변수

Name Type 인수 설명

recordCount

integer

건너뛸 레코드의 수입니다.

take(recordCount)
recordCount개의 레코드를 반환하는 Query 개체 인스턴스를 반환합니다.

매개 변수

Name Type 인수 설명

recordCount

integer

반환할 레코드의 수입니다.

where(object)
제공된 JSON object의 속성 값을 기준으로 필터링되는 Query 개체 인스턴스를 반환합니다.

매개 변수

Name Type 인수 설명

개체

개체

필터링할 속성 값이 포함된 JSON 개체입니다.

where(function)
제공된 함수를 기준으로 필터링되는 Query 개체 인스턴스를 반환합니다.

매개 변수

Name Type 인수 설명

function

함수

요청한 function 필터가 적용된 Query 개체 인스턴스를 반환합니다. 함수 정의에서 this 키워드는 행에 액세스하고 점 연산자는 열에 액세스합니다. 이러한 항목에 JavaScript 함수를 적용할 수 있습니다.

update(item, options)
지정된 item을 테이블에 삽입합니다.

매개 변수

Name Type 인수 설명

item

개체

삽입할 항목입니다

옵션

콜백 함수입니다.

insert, updatedel 메서드는 성공 또는 오류 처리기가 정의되어 있을 수 있는 options object개체를 허용합니다.

Query 메서드(orderBy, orderByDescending, select, skip, takewhere)는 모두 새 Query 개체를 반환합니다. 이 개체는 일련의 메서드 호출로 쿼리를 작성할 수 있는 동일한 메서드를 노출합니다.

몇 가지 예는 다음과 같습니다.

  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를 호출하는 방법을 보여 줍니다.

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

표시:
© 2015 Microsoft