01
예제 종류 바꾸기
FLWOR 외에 외부 변수, 네임스페이스, 고의적인 문법 오류를 고를 수 있습니다. 예제는 세 입력을 미리 보여 준 뒤 적용하고 한 번 되돌릴 수 있습니다.
- 오류 예제는 위치 표시를 확인하는 용도입니다.
XML 도구
XQuery 테스트내 문서로 질의를 확인하세요
필터, 정렬, 새 요소 생성 예제가 준비되어 있습니다. 수정한 뒤 Ctrl/Cmd+Enter로 다시 실행할 수 있습니다.
XQuery 테스트
XML 입력
XQuery 프로그램
결과
XML과 쿼리는 이 브라우저에서 처리되며 문서를 서버로 보내지 않습니다.
간단한 이름 최대 32개, 값은 문자열·유한한 숫자·불리언입니다. 질의에서 external로 선언하세요.
XQuery 3.1 일부 지원. XML 한 개만 사용하며 doc(), 모듈, 업데이트는 제외합니다. 실행 제한 3초.
결과가 오래되었습니다. 다시 평가하면 내보낼 수 있습니다.
노드를 찾는 것에서 그치지 않고 조건으로 골라 정렬하고 새 XML을 만들 때 XQuery 테스트가 필요합니다. 첫 예제는 실제 XQuery 3.1 엔진으로 책 두 권을 결과 요소로 만듭니다.
작은 XQuery 실행 환경에서 데이터베이스에 넣기 전 오류를 재현하세요. 이 XML 질의는 붙여 넣은 문서 한 개만 사용하며 URL이나 컬렉션에 접근하지 않습니다.
XQuery 테스트를 쓰는 이유
실행 결과와 문서 접근 범위를 함께 확인합니다.
선택한 값으로 새 요소 만들기
XQuery 테스트는 for, where, order by, return을 실행합니다. 기본 예제는 가격으로 책을 골라 정렬하고 result 요소를 만드므로 XPath 1.0의 단순 선택과 다릅니다.
외부 리소스와 분리하기
입력한 XML 한 개만 질의합니다. doc(), 컬렉션, 외부 모듈을 요청하면 오류가 나며, 오래 걸리는 작업은 Worker를 종료합니다.
결과를 믿기 전에 볼 세 가지
02
변수를 선언하고 전달하기
JSON에 {"minimum":20}을 넣고 질의에는 declare variable $minimum external;을 씁니다. 값을 질의 문자열에 이어 붙이지 않고 바인딩합니다.
- 문자열, 유한한 숫자, 불리언만 받습니다.
03
수정 후 명시적으로 재실행하기
짧은 XQuery 문법만으로도 큰 결과가 생길 수 있어 자동 실행하지 않습니다. XML, 질의, 변수를 바꾸면 이전 결과의 복사와 다운로드가 즉시 막힙니다.
- 결과 0개는 성공이고 시간 초과는 실패입니다.
질의가 실제로 한 일을 확인
FLWOR와 요소 생성
조건에 맞는 XML을 골라 순서를 정한 후 새 요소를 만듭니다. 생성된 노드는 텍스트로 표시하고 HTML로 실행하지 않습니다.
외부 변수 바인딩
JSON 값을 external 선언 변수에 전달합니다. 질의 본문을 바꾸지 않고 숫자 기준만 변경해 다시 시험할 수 있습니다.
빈 결과와 실패 구분
일치 항목이 없는 올바른 질의는 0개로 성공합니다. 잘못된 XML, 선언하지 않은 변수, 문법 오류는 별도 오류로 나타납니다.
지원 범위와 자원 한도
- XQuery 3.1의 일부만 지원
- FontoXPath 3.34.0에서 검증한 FLWOR와 요소 생성 기능을 사용합니다. group by, count 절, 윈도 절, 스키마 형식, 데이터베이스 확장은 보장하지 않습니다.
- 외부 문서와 업데이트 제외
- doc(), collection(), unparsed-text(), 모듈 가져오기와 XQuery Update는 지원하지 않습니다. 입력한 XML이 유일한 문서 컨텍스트입니다.
- 엄격한 XML과 실행 예산
- 올바른 XML 1.0만 받고 DOCTYPE와 외부 엔터티를 거부합니다. XML 10만 자, 질의와 변수 각 1만 자, 노드 5,000개, 깊이 100, 변수 32개, 출력 100만 자, 실행 3초가 상한입니다.
- 잘린 결과는 내보내지 않음
- 한도 초과 시 전체 실행이 실패합니다. 예제와 지우기는 미리 보기를 거쳐 적용하며, 한 번 되돌려 입력과 결과를 복원합니다.
XQuery 테스트 관련 질문
XML 문서에 XQuery를 실행하려면?
파일의 XML 내용을 입력란에 붙여 넣고 질의문을 실행하세요. 파일 경로나 URL, 컬렉션에서 문서를 불러오지는 않습니다.
XQuery 외부 변수는 어떻게 전달하나요?
질의에 declare variable $minimum external;을 선언하고 변수란에 {"minimum":20}을 입력합니다. 값은 질의 텍스트에 삽입되지 않고 바인딩됩니다.
네임스페이스가 있는 XML을 XQuery로 조회하려면?
질의 처음에 네임스페이스 URI에 대한 접두사를 선언하고 경로에서 그 접두사를 쓰세요. 네임스페이스 예제가 기본 네임스페이스 XML을 보여 줍니다.
XQuery 결과를 XML로 출력하려면?
return 절에서 <result>{$book/title/text()}</result>처럼 요소를 만드세요. 반환된 노드는 XML 텍스트로 직렬화되며 브라우저 HTML로 실행되지 않습니다.
XPath와 XQuery의 차이는 무엇인가요?
XPath는 문서 노드 선택과 값 계산에 초점을 둡니다. XQuery는 변수와 FLWOR 및 요소 생성으로 결과 구조까지 만들 수 있습니다.
예상과 다른 결과인가요?