사설 토토comment(텍스트)

함수사설 토토comment지정된 텍스트가 포함된 XML 주석이 포함된 XML 값을 콘텐츠로 생성합니다. 텍스트에는 다음이 포함될 수 없습니다.“--”또는 a로 끝남“-”그래서 결과 구성은 유효한 사설 토토 주석입니다. 인수가 null이면 결과도 null입니다.

예:

SELECT 사설 토토comment('안녕하세요');

  사설 토토주석
--------------
 <!--안녕하세요--

사설 토토concat(사설 토토[, ...])

함수사설 토토concat개별 사설 토토 값 목록을 연결하여 사설 토토 콘텐츠 조각을 포함하는 단일 값을 생성합니다. Null 값은 생략됩니다. null이 아닌 인수가 없는 경우에만 결과는 null입니다.

예:

SELECT 사설 토토concat('<abc/', '<barfoo</bar');

      사설 토토concat
---------
 <abc/<barfoo</bar

XML 선언이 있는 경우 다음과 같이 결합됩니다. 모든 인수 값에 동일한 XML 버전 선언이 있으면 해당 버전이 결과에 사용되며, 그렇지 않으면 버전이 사용되지 않습니다. 모든 인수 값이 독립형 선언 값을 갖는 경우“예”이면 해당 값이 결과에 사용됩니다. 모든 인수 값에 독립형 선언 값이 있고 적어도 하나가 다음과 같은 경우“아니요”이면 결과에 사용됩니다. 그렇지 않으면 결과에 독립형 선언이 없습니다. 결과가 독립 실행형 선언이 필요하고 버전 선언이 필요하지 않은 것으로 결정된 경우 사설 토토에는 버전 선언을 포함하기 위한 사설 토토 선언이 필요하므로 버전 1.0의 버전 선언이 사용됩니다. 인코딩 선언은 모든 경우에 무시되고 제거됩니다.

예:

SELECT 사설 토토concat('<?사설 토토 version="1.1"?<foo/', '<?사설 토토 version="1.1"standalone="no"?<bar/');

             사설 토토concat
----------------------
 <?사설 토토 version="1.1"?<foo/<bar/

사설 토토요소(이름이름 [, 사설 토토속성(값 [ASattname] [, ... ])] [, 콘텐츠, ...])

그사설 토토요소표현식은 지정된 이름, 속성 및 콘텐츠를 포함하는 XML 요소를 생성합니다.

예:

SELECT 사설 토토element(이름 foo);

 사설 토토요소
------------
 <푸/

SELECT 사설 토토element(이름 foo, 사설 토토attributes('xyz' 막대형));

    사설 토토요소
------------------
 <foo bar="xyz"/

SELECT 사설 토토element(이름 foo, 사설 토토attributes(현재_날짜를 막대로), 'cont', 'ent');

             사설 토토요소
------------------------
 <foo bar="2007-01-26"콘텐츠</foo

유효한 XML 이름이 아닌 요소 및 속성 이름은 잘못된 문자를 시퀀스로 대체하여 이스케이프됩니다._x흐흐흐흐_, 여기서흐흐흐흐은 16진수 표기법으로 표시된 문자의 유니코드 코드 포인트입니다. 예를 들면:

SELECT 사설 토토element(이름 "foo$bar", 사설 토토attributes('xyz' as "a&b"));

            사설 토토요소
----------------------------------
 <foo_x0024_bar a_x0026_b="xyz"/

속성 값이 열 참조인 경우 명시적인 속성 이름을 지정할 필요가 없습니다. 이 경우 열 이름은 기본적으로 속성 이름으로 사용됩니다. 다른 경우에는 속성에 명시적인 이름을 지정해야 합니다. 따라서 이 예는 유효합니다.

CREATE TABLE 테스트(a 사설 토토, b 사설 토토);
SELECT 사설 토토element(name test, 사설 토토attributes(a, b)) FROM test;

그러나 이것은 그렇지 않습니다:

SELECT 사설 토토element(name test, 사설 토토attributes('constant'), a, b) FROM test;
SELECT 사설 토토element(name test, 사설 토토attributes(func(a, b))) FROM test;

지정된 경우 요소 콘텐츠는 해당 데이터 유형에 따라 형식이 지정됩니다. 콘텐츠 자체가 유형인 경우사설 토토, 복잡한 XML 문서를 구성할 수 있습니다. 예를 들면:

SELECT 사설 토토element(이름 foo, 사설 토토attributes('xyz'를 막대로),
                            사설 토토element(이름 abc),
                            사설 토토comment('테스트'),
                            사설 토토element(이름 xyz));

                  사설 토토요소
---------------------------------
 <foo bar="xyz"<abc/<!--test--<xyz/</foo

다른 유형의 콘텐츠는 유효한 사설 토토 문자 데이터로 형식화됩니다. 이는 특히 <, 및 & 문자가 엔터티로 변환됨을 의미합니다. 바이너리 데이터(데이터 유형바이테아)은 구성 매개변수의 설정에 따라 base64 또는 16진수 인코딩으로 표시됩니다.사설 토토binary. 개별 데이터 유형에 대한 특정 동작은 PostgreSQL 매핑을 SQL:2006 이상에 지정된 매핑과 일치시키기 위해 발전할 것으로 예상됩니다.섹션 D.3.1.3.

사설 토토forest(내용 [AS이름] [, ...])

그사설 토토forest표현식은 주어진 이름과 콘텐츠를 사용하여 요소의 XML 포리스트(시퀀스)를 생성합니다.

예:

SELECT 사설 토토forest('abc' AS foo, 123 AS bar);

          사설 토토forest
-----------------
 <fooabc</foo<bar123</bar

SELECT 사설 토토forest(테이블_이름, 열_이름)
정보_스키마.열에서
WHERE table_schema = 'pg_catalog';

                                         사설 토토forest
-----------------------------------------------------------------
 <table_namepg_authid</table_name<column_name롤 이름</column_name
 <table_namepg_authid</table_name<column_namerolsuper</column_name
 ...

두 번째 예에서 볼 수 있듯이 콘텐츠 값이 열 참조인 경우 요소 이름을 생략할 수 있으며, 이 경우 기본적으로 열 이름이 사용됩니다. 그렇지 않으면 이름을 지정해야 합니다.

유효한 XML 이름이 아닌 요소 이름은 다음과 같이 이스케이프됩니다.사설 토토요소위. 마찬가지로 콘텐츠 데이터는 이미 유형이 아닌 한 유효한 사설 토토 콘텐츠를 만들기 위해 이스케이프됩니다.사설 토토.

XML 포리스트는 둘 이상의 요소로 구성된 경우 유효한 XML 문서가 아니므로 래핑하는 것이 유용할 수 있습니다.사설 토토forest표현식사설 토토요소.

사설 토토pi(이름대상 [, 내용])

그사설 토토pi표현식은 XML 처리 명령을 생성합니다. 콘텐츠가 있는 경우 문자 시퀀스를 포함해서는 안 됩니다.?.

예:

SELECT 사설 토토pi(php 이름, 'echo "hello world";');

            사설 토토pi
----------------
 <?php echo "hello world";?

사설 토토root(사설 토토, 버전텍스트| 값 없음 [, 독립 실행형 yes|no|no 값])

그사설 토토root표현식은 XML 값의 루트 노드 속성을 변경합니다. 버전이 지정되면 루트 노드의 버전 선언에 있는 값이 대체됩니다. 독립 실행형 설정이 지정된 경우 루트 노드의 독립 실행형 선언 값을 대체합니다.

SELECT 사설 토토root(사설 토토parse(문서 '<?사설 토토 version="1.1"?<contentabc</content')),
               버전 '1.0', 독립형 예);

                사설 토토root
---------------------------
 <?사설 토토 version="1.0" 독립형="예"?
 <contentabc</content

사설 토토agg(사설 토토)

함수사설 토토agg은 여기에 설명된 다른 함수와 달리 집계 함수입니다. 다음과 같이 입력 값을 집계 함수 호출에 연결합니다.사설 토토concat단, 단일 행의 표현식 전체가 아닌 행 전체에서 연결이 발생한다는 점을 제외하면 그렇습니다. 참조PostgreSQL : 문서 : 11 : 9.20. 윈 토토 기능집계 함수에 대한 추가 정보를 확인하세요.

예:

CREATE TABLE 테스트(y int, x 사설 토토);
테스트 값에 삽입(1, '<fooabc</foo');
테스트 값에 삽입(2, '<bar/');
SELECT 사설 토토agg(x) FROM 테스트;
        사설 토토agg
---------
 <fooabc</foo<bar/

연결 순서를 결정하려면,주문 기준절은 다음에 설명된 대로 집계 호출에 추가될 수 있습니다.섹션 4.2.7. 예를 들면:

SELECT 사설 토토agg(x ORDER BY y DESC) FROM 테스트;
        사설 토토agg
---------
 <bar/<fooabc</foo

다음의 비표준 접근 방식은 이전 버전에서 권장되었지만 특정 경우에는 여전히 유용할 수 있습니다.

SELECT 사설 토토agg(x) FROM (SELECT * FROM test ORDER BY y DESC) AS 탭;
        사설 토토agg
---------
 <bar/<fooabc</foo

사설 토토IS 문서

표현식IS 문서인수 XML 값이 적절한 XML 문서이면 true를 반환하고, 그렇지 않으면(즉, 콘텐츠 조각) false를 반환하며, 인수가 null이면 null을 반환합니다. 참조섹션 8.13문서와 콘텐츠 조각의 차이점에 대해.

사설 토토문서가 아님

표현식문서가 아님인수 XML 값이 적절한 XML 문서이면 false를 반환하고, 그렇지 않으면(즉, 콘텐츠 조각) true를 반환하며, 인수가 null이면 null을 반환합니다.

사설 토토EXISTS(텍스트통과 중 [참조 기준] 사설 토토 [참조 기준])

함수사설 토토exists은 전달된 XML 값을 컨텍스트 항목으로 사용하여 XPath 1.0 표현식(첫 번째 인수)을 평가합니다. 해당 평가 결과가 빈 노드 집합이면 함수는 false를 반환하고, 다른 값을 생성하면 true를 반환합니다. 인수가 null인 경우 함수는 null을 반환합니다. 컨텍스트 항목으로 전달된 Null이 아닌 값은 콘텐츠 조각이나 비XML 값이 아닌 XML 문서여야 합니다.

예:

SELECT 사설 토토exists('//town[text() = ''토론토'']' PASSING BY REF '<towns<town토론토</town<town오타와</town</towns');

 XML이 존재한다
------------
 티
(1행)

그참조 기준절은 다음에서 허용됩니다.PostgreSQL, 그러나 설명된 대로 무시됩니다.섹션 D.3.2. SQL 표준에서는사설 토토exists함수는 XML 쿼리 언어로 표현식을 평가하지만포스트그레SQL에서 설명한 대로 XPath 1.0 표현식만 허용합니다.섹션 D.3.1.

사설 토토_is_well_formed(텍스트)
사설 토토_is_well_formed_document(텍스트)
사설 토토_is_well_formed_content(텍스트)

이 함수는 다음을 확인합니다.텍스트string은 부울 결과를 반환하는 올바른 형식의 사설 토토입니다.사설 토토_is_well_formed_document잘 구성된 문서를 확인하는 동안사설 토토_is_well_formed_content잘 구성된 콘텐츠를 확인합니다.사설 토토_is_well_formed다음의 경우 전자를 수행합니다사설 토토option구성 매개변수가 다음으로 설정되었습니다.문서, 또는 후자로 설정된 경우콘텐츠. 이는 다음을 의미합니다.사설 토토_is_well_formed간단한 유형 변환 여부를 확인하는 데 유용합니다.사설 토토성공할 것이지만 다른 두 함수는 해당 변형이 있는지 확인하는 데 유용합니다.사설 토토PARSE성공할 것입니다.

예:

XML 옵션을 문서로 설정;
SELECT 사설 토토_is_well_formed('<');
 사설 토토_is_well_formed 
-------
 에프
(1줄)

SELECT 사설 토토_is_well_formed('<abc/');
 사설 토토_is_well_formed 
-------
 티
(1줄)

사설 토토option을 콘텐츠로 설정;
SELECT 사설 토토_is_well_formed('abc');
 사설 토토_is_well_formed 
-------
 티
(1줄)

SELECT 사설 토토_is_well_formed_document('<pg:foo 사설 토토ns:pg="http://postgresql.org/stuff"bar</pg:foo');
 사설 토토_is_well_formed_document 
----------------
 티
(1줄)

SELECT 사설 토토_is_well_formed_document('<pg:foo 사설 토토ns:pg="http://postgresql.org/stuff"bar</my:foo');
 사설 토토_is_well_formed_document 
----------------
 에프
(1행)

마지막 예는 검사에 네임스페이스가 올바르게 일치하는지 여부가 포함되어 있음을 보여줍니다.

xpath(xpath, 사설 토토 [, nsarray])

함수xpathXPath 1.0 표현식을 평가합니다.xpath(a텍스트값)을 사설 토토 값에 대해사설 토토. XPath 표현식으로 생성된 노드 세트에 해당하는 XML 값의 배열을 반환합니다. XPath 표현식이 노드 집합이 아닌 스칼라 값을 반환하는 경우 단일 요소 배열이 반환됩니다.

두 번째 인수는 올바른 형식의 XML 문서여야 합니다. 특히 단일 루트 노드 요소가 있어야 합니다.

함수의 선택적 세 번째 인수는 네임스페이스 매핑의 배열입니다. 이 배열은 2차원 배열이어야 합니다.텍스트두 번째 축의 길이가 2인 배열(즉, 각각 정확히 2개의 요소로 구성된 배열의 배열이어야 합니다). 각 배열 항목의 첫 번째 요소는 네임스페이스 이름(별칭)이고 두 번째 요소는 네임스페이스 URI입니다. 이 배열에 제공된 별칭이 XML 문서 자체(즉, XML 문서와xpath함수 컨텍스트, 별칭은현지).

예:

SELECT xpath('/my:a/text()', '<my:a 사설 토토ns:my="http://example.com"테스트</my:a',
             ARRAY[ARRAY['my', 'http://example.com']]);

 xpath  
--------
 테스트

기본(익명) 네임스페이스를 처리하려면 다음과 같이 하십시오:

SELECT xpath('//mydefns:b/text()', '<a 사설 토토ns="http://example.com"<b테스트</b</a',
             ARRAY[ARRAY['mydefns', 'http://example.com']]);

 xpath
--------
 테스트

xpath_exists(xpath, 사설 토토 [, nsarray])

함수xpath_exists는의 특수한 형식입니다.xpath함수. XPath 1.0 표현식을 충족하는 개별 XML 값을 반환하는 대신 이 함수는 쿼리가 충족되었는지 여부(구체적으로 빈 노드 집합 이외의 값을 생성했는지 여부)를 나타내는 부울 값을 반환합니다. 이 함수는 다음과 동일합니다.사설 토토EXISTS술어. 단, 네임스페이스 매핑 인수에 대한 지원도 제공한다는 점은 제외.

예:

SELECT xpath_exists('/my:a/text()', '<my:a 사설 토토ns:my="http://example.com"테스트</my:a',
                     ARRAY[ARRAY['my', 'http://example.com']]);

 xpath_exists  
--------------
 티
(1행)

사설 토토table( [사설 토토NAMESPACES(네임스페이스 URIAS네임스페이스 이름[, ...]), ]
          행_표현통과 중 [참조 기준] 문서_표현 [참조 기준]
          열이름 { 유형 [경로열 표현] [기본값기본_표현] [NULL이 아님 | NULL]
                        | 순서대로 
                   [, ...]
)

그사설 토토테이블함수는 주어진 XML 값, 행을 추출하는 XPath 필터 및 열 정의 세트를 기반으로 테이블을 생성합니다.

선택사항사설 토토NAMESPACES절은 쉼표로 구분된 네임스페이스 목록입니다. 문서에 사용되는 XML 네임스페이스와 해당 별칭을 지정합니다. 기본 네임스페이스 사양은 현재 지원되지 않습니다.

필수행_표현인수는 평가되는 XPath 1.0 표현식이며, 다음을 전달합니다.문서_표현컨텍스트 항목으로 XML 노드 세트를 얻습니다. 이 노드는 무엇입니까사설 토토table은 출력 행으로 변환됩니다. 다음과 같은 경우 행이 생성되지 않습니다.문서_표현이 null이거나 다음과 같은 경우도 아닙니다.행_표현빈 노드 집합 또는 노드 집합 이외의 값을 생성합니다.

문서_표현에 대한 컨텍스트 항목을 제공합니다.행_표현. 올바른 형식의 XML 문서여야 합니다. 조각/숲은 허용되지 않습니다.참조 기준절은 허용되지만 무시됩니다. 설명된 대로섹션 D.3.2. SQL 표준에서는사설 토토table함수는 XML 쿼리 언어의 표현식을 평가하지만PostgreSQL에서 설명한 대로 XPath 1.0 표현식만 허용합니다.섹션 D.3.1.

필수사항열절은 출력 테이블의 열 목록을 지정합니다. 각 항목은 단일 열을 설명합니다. 형식은 위의 구문 요약을 참조하세요. 열 이름과 유형은 필수입니다. 경로, 기본 및 null 허용 여부 절은 선택 사항입니다.

표시된 열순서의 경우은(는) 에서 검색된 노드 순서대로 1부터 시작하는 행 번호로 채워집니다.행_표현의 결과 node-set. 최대 하나의 열이 표시될 수 있습니다.순서의 경우.

그열 표현열의 경우 현재 노드를 사용하여 각 행에 대해 평가되는 XPath 1.0 표현식입니다.행_표현결과를 컨텍스트 항목으로 사용하여 열의 값을 찾습니다. 그렇지 않은 경우열 표현이 주어지면 열 이름이 암시적 경로로 사용됩니다.

열의 XPath 표현식이 비XML 값(XPath 1.0에서는 문자열, 부울 또는 double로 제한됨)을 반환하고 열에 PostgreSQL 이외의 유형이 있는 경우사설 토토, 값의 문자열 표현을 PostgreSQL 유형에 할당하는 것처럼 열이 설정됩니다. 이 릴리스에서는 XPath 부울 또는 이중 결과를 명시적으로 문자열로 변환해야 합니다(즉, XPath 1.0문자열원래 열 표현식 주위에 함수가 래핑됨);PostgreSQL40559_40731섹션 D.3.1.3.

이 릴리스에서는 SQL 결과 열사설 토토유형 또는 XML 유형으로 평가되는 열 XPath 표현식은 출력 열 SQL 유형에 관계없이 다음에 설명된 대로 처리됩니다.섹션 D.3.2; 동작이 크게 변경됨포스트그레SQL 12.

경로 표현식이 주어진 행에 대해 빈 노드 세트(일반적으로 일치하지 않는 경우)를 반환하는 경우 열은 다음으로 설정됩니다.NULL, a가 아닌 경우기본_표현지정되었습니다. 그런 다음 해당 표현식을 평가한 결과 값이 사용됩니다.

열이 표시될 수 있습니다.NULL이 아님. 만약열 표현에 대한NULL이 아님열이 일치하는 항목이 없으며 해당 항목도 없습니다.기본값또는기본_표현또한 null로 평가되면 오류가 보고됩니다.

A 기본_표현, 다음과 같은 경우 즉시 평가되기보다는사설 토토테이블이 호출되며 열에 기본값이 필요할 때마다 평가됩니다. 표현식이 안정적이거나 불변인 경우 반복 평가를 건너뛸 수 있습니다. 이는 다음과 같은 휘발성 함수를 유용하게 사용할 수 있음을 의미합니다.다음발in기본_표현.

예:

선택으로 테이블 사설 토토데이터 생성
XML $$
<행
  <ROW id="1"
    <COUNTRY_IDAU</COUNTRY_ID
    <COUNTRY_NAME호주</COUNTRY_NAME
  </ROW
  <ROW id="5"
    <COUNTRY_ID일본</COUNTRY_ID
    <COUNTRY_NAME일본</COUNTRY_NAME
    <PREMIER_NAME아베 신조</PREMIER_NAME
    <SIZE 단위="sq_mi"145935</SIZE
  </ROW
  <ROW id="6"
    <COUNTRY_IDSG</COUNTRY_ID
    <COUNTRY_NAME싱가포르</COUNTRY_NAME
    <SIZE 단위="sq_km"697</SIZE
  </ROW
</ROWS
$$ AS 데이터;

XML테이블을 선택하세요.*
  XML데이터에서,
       사설 토토TABLE('//ROWS/ROW'
                데이터 전달 중
                열 id int PATH '@id',
                        순서에 대한 순서,
                        "COUNTRY_NAME" 텍스트,
                        country_id 텍스트 PATH 'COUNTRY_ID',
                        size_sq_km float PATH 'SIZE[@unit = "sq_km"]',
                        size_other 텍스트 경로
                             'concat(SIZE[@unit!="sq_km"], " ", SIZE[@unit!="sq_km"]/@unit)',
                        premier_name 텍스트 PATH 'PREMIER_NAME' DEFAULT '지정되지 않음') ;

 아이디 | 순서성 | 국가_이름 | 국가_ID | size_sq_km |  사이즈_기타 | 프리미어_이름  
----+------------+------------+------------+------------+------------+---------------+---------------
  1 |          1 | 호주 | 호주 |            |              | 지정되지 않음
  5 |          2 | 일본 | 일본 |            | 145935 sq_mi | 아베 신조
  6 |          3 | 싱가포르 | SG |        697 |              | 지정되지 않음

다음 예에서는 여러 text() 노드 연결, XPath 필터로 열 이름 사용, 공백 처리, XML 주석 및 처리 지침을 보여줍니다.

선택으로 테이블 사설 토토요소 생성
XML $$
  <루트
   <element 안녕하세요<!-- xyxxz --2a2<?aaaaa? <!--x-- bbb<xxxx</xCC </element
  </root
$$ AS 데이터;

XML테이블을 선택하세요.*
  FROM 사설 토토elements, 사설 토토TABLE('/root' PASSING 데이터 COLUMNS 요소 텍스트);
       요소        
---------
   Hello2a2 bbbCC

다음 예는 다음의 방법을 보여줍니다.사설 토토NAMESPACES절은 XML 문서와 XPath 표현식에 사용되는 네임스페이스 목록을 지정하는 데 사용할 수 있습니다.

WITH 사설 토토data(data) AS (VALUES ('
<예 사설 토토ns="http://example.com/myns" 사설 토토ns:B="http://example.com/b"
 <item foo="1" B:bar="2"/
 <item foo="3" B:bar="4"/
 <item foo="4" B:bar="5"/
</예'::사설 토토)
)
XML테이블을 선택하세요.*
  FROM 사설 토토TABLE(사설 토토NAMESPACES('http://example.com/myns' AS x,
                              'http://example.com/b' AS "B"),
             '/x:예제/x:항목'
                통과(사설 토토data에서 데이터 선택)
                열 foo int PATH '@foo',
                  bar int PATH '@B:bar');
 푸 | 바
-----+------
   1 |   2
   3 |   4
   4 |   5
(3행)