이 페이지는 기계 번역을 사용하여 번역되었습니다. 영어 원문을 보려면 여기를 클릭하십시오.

tags

PI Data Archive의 태그 목록

R2022a 이후

페이지 내 모두 축소

구문

tagList = tags(piClientObj)
tagList = tags(piClientObj,Name=tagQuery)

설명

tagList = tags(piClientObj)는 AVEVA® PI Data Archive에서 사용할 수 있는 모든 태그의 목록을 반환하며, 이 아카이브는 piCientObj로 지정된 클라이언트에 연결되어 있습니다. 태그는 PI 시스템에서 전압, 전류, 온도 등과 같은 자산 특성을 나타내는 별칭 또는 바로 가기로 사용됩니다. 일부 태그 이름은 짧고, 다른 태그 이름은 길고 설명적일 수도 있으며 고유 ID가 포함될 수도 있습니다.

tagList = tags(piClientObj,Name=tagQuery)는 사용 가능한 태그를 검색하여 tagQuery에 지정된 쿼리를 충족하는 태그 목록을 반환합니다.

참고

MATLAB®에서 PI 서버에 연결하려면 AF SDK 라이브러리를 설치해야 합니다. 자세한 내용은 AF SDK 개요를 참조하십시오.

예제

예제

모두 축소

AVEVA PI Data Archive에 있는 모든 태그 목록을 요청합니다.

tagList = tags(piClientObj);

PI Data Archive에서 일치하는 문자열을 포함하는 모든 태그 목록을 요청합니다.

tagList = tags(piClientObj, Name="*pressure*");

입력 인수

모두 축소

AVEVA PI Data Archive에 연결된 클라이언트로, icomm.pi.Client 객체로 지정됩니다. piclient 함수를 사용하여 객체를 생성합니다.

예: piClientObj = piclient("pi-host-55")

데이터형: object

태그를 검색하기 위한 쿼리로, string형 또는 문자형 벡터로 지정됩니다. AFSDK에서 지원하는 모든 유효한 쿼리 문자열을 사용할 수 있습니다. 자세한 내용은 PI 포인트 쿼리 구문 개요를 참조하십시오.

예: tags(piclientObj,Name="windspeed")는 이름이 지정된 이름 "windspeed"와 정확히 일치하는 태그를 검색합니다.

예: tags(piclientObj,Name="*wind*")는 이름의 어느 위치에든 지정된 부분 문자열 "wind"가 포함된 태그를 검색합니다.

예: tags(piclientObj,Name="description:weather\ data")는 설명이 지정된 검색어 "weather data"와 일치하는 태그를 검색합니다.

예: tags(piclientObj, Name="name:wind* AND description:weather\ data")는 이름이 "wind"로 시작하고 설명이 "weather data"인 태그를 검색합니다.

데이터형: char | string

출력 인수

모두 축소

AVEVA PI Data Archive의 태그 목록으로, 행당 하나의 태그가 포함된 N×1 크기의 문자열 테이블 형태로 반환됩니다.

버전 내역

R2022a에 개발됨

참고 항목

함수