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