데이터 테이블 서비스
데이터 테이블 셰이프에 관한 데이터 테이블에서 데이터를 가져오거나 내보내기 위한 여러 기본 제공 서비스가 있습니다. 다음과 같습니다.
서비스
설명
AddDataTableEntry(TAGS tags, VALUES values)
VALUEStags(선택 사항)를 전달합니다. 부울 반환은 성공 또는 실패를 나타냅니다.
AddDataTableEntries
여러 데이터 테이블 엔트리를 추가합니다.
AddOrUpdateDataTableEntry (TAGS tags, VALUES values)
VALUEStags(선택 사항)를 전달합니다. 데이터 테이블에서 새 엔트리 또는 업데이트된 엔트리의 streamID에 대한 STRING 값을 반환합니다. 존재하는 경우 행을 업데이트하고, 그렇지 않으면 행이 추가됩니다.
AddOrUpdateDataTableEntries
여러 데이터 테이블 엔트리를 추가 또는 업데이트합니다. 존재하는 경우 행을 업데이트하고, 그렇지 않으면 행이 추가됩니다. 업데이트하려면 기본 키가 일치해야 합니다.
AssignDataTableEntries
기존 데이터 테이블 엔트리를 바꿉니다.
DeleteDataTableEntry (STRING keyvalue)
키 값에 따라 단일 엔트리를 삭제합니다. 부울 반환은 성공 또는 실패를 나타냅니다.
* 
엔트리를 삭제하려면 기본 키가 필요합니다.
DeleteDataTableEntries
인포테이블 입력 매개 변수에 제공된 값의 첫 번째 행과 일치하는 여러 엔트리를 삭제합니다. 예를 들어, 데이터 테이블에 Int01 필드가 있으며 세 개의 엔트리에서 Int0110으로 설정되었다고 가정합니다. 실행 시 삭제 조건으로 10이 지정되면 DeleteDataTableEntries는 세 개의 엔트리를 모두 삭제합니다.
* 
인포테이블 입력 매개 변수에 값의 행이 둘 이상 제공되면 "Invalid Number of values provided to DeleteDataTableEntries in thingName"이라는 오류가 표시됩니다.
FindDataTableEntries
색인만 검색합니다. 따라서 QueryDataTableEntries 서비스보다 신속하게 사용할 수 있습니다.
* 
데이터 테이블에 대한 구성에 둘 이상의 색인이 정의되어 있는 경우 검색하는 데 사용되는 색인에 FindDataTableEntries에 전달하는 값 매개 변수에서 검색할 필드로 표시한 것에 따라 가중치가 지정됩니다. 예를 들어, 4개의 속성(INTEGER, BOOLEAN, STRING 및 TEXT)이 있고 두 개의 색인(BOOLEAN 및 STRING에 하나, TEXT에 하나)을 생성한 경우 TEXT 속성에 대해 검색할 값만 지정하면 해당 색인에서 검색할 값을 제공했기 때문에 색인에 BOOLEAN/STRING 색인보다 더 중요하게 가중치가 지정됩니다.
* 
FindDataTableEntries에는 하나의 인포테이블 입력 매개 변수만 허용됩니다. 입력이 없거나 입력 매개 변수가 둘 이상 제공된 경우 결과가 반환되지 않습니다.
GetDataTableEntries (NUMBER maxItems)
요청된 최대 항목 수만큼 최신 엔트리를 반환합니다.
GetDataTableEntry (STRING keyvalue)
한 개 행의 인포테이블을 일치하는 엔트리와 함께 반환합니다.
GetFieldNames
이 데이터 테이블과 연관된 필드 이름 목록을 반환합니다.
PurgeDataTableEntries
이 데이터 테이블에 대한 모든 엔트리를 제거합니다. 부울 반환은 성공 또는 실패를 나타냅니다.
QueryDataTableEntries (NUMBER maxItems, STRING queryExpression, TAGS tags, VALUES query)
요청 매개 변수와 일치하는 레코드의 인포테이블을 반환합니다.
* 
QueryDataTableEntries에는 하나의 인포테이블 입력 매개 변수만 허용됩니다.
입력 매개 변수가 제공되지 않으면 QueryDataTableEntries에서 데이터 테이블의 모든 행을 반환합니다.
입력 매개 변수가 둘 이상 제공되면 첫 번째 입력과 일치하는 행만 반환되고 다른 입력은 무시됩니다. 이 경우 서비스의 질의 입력 매개 변수를 사용합니다.
SearchDataTableEntries
검색 질의 매개 변수와 일치하는 데이터 테이블 엔트리를 모두 반환합니다. searchExpression은 이 서비스에 대한 키입니다. 여기에는 STRING 및 TEXT 필드만을 검색하는 전체 텍스트가 포함됩니다. searchExpression에 사용할 수 있는 파일러는 +(더하기 기호), 대/소문자 구분, ?(물음표), % (퍼센트 기호), ANDOR입니다.
UpdateDataTableEntry(TAGS tags, VALUES values)
valuestags(선택 사항)를 전달합니다. 부울 반환은 성공 또는 실패를 나타냅니다. 존재하는 경우 행을 업데이트합니다.
데이터 테이블 검색에서 대/소문자 구분 정의
질의 매개 변수에 필터를 사용하여 데이터 테이블 검색에서 대/소문자 구분을 정의할 수 있습니다.
예를 들어, 다음 엔트리가 있는 SearchDataTableEntries 서비스를 사용합니다.
대/소문자 구분 결과를 반환하도록 query 매개 변수에 대한 필터를 정의할 수 있습니다. 예:
{"filters":{"type":"EQ", "fieldName":"Field1","isCaseSensitive":true, "value":"AA"}}
위 질의를 사용하면 다음과 같은 결과가 반환됩니다.
동일한 서비스를 사용하는 다른 예에서는 질의 매개 변수에 다음 필터를 사용합니다.
{"filters":{"type":"EQ", "fieldName":"Field1","isCaseSensitive":true, "value":"aa"}}
다음 결과가 반환됩니다.
도움이 되셨나요?