지원되는 버전:현재 (18) / 17 / 16 / 15 / 14 / 13
개발 버전:개발
지원되지 않는 버전:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3
이 문서는 지원되지 않는 PostgreSQL 버전에 대한 것입니다.
당신은 다음과 같은 페이지를 보고 싶을 수도 있습니다.현재버전 또는 위에 나열된 다른 지원 버전 중 하나를 사용하세요.

9.14. XML 함수

여기에 설명된 함수 및 함수와 유사한 표현식 섹션은 유형의 값에 대해 작동합니다.사설 토토. 확인섹션 8.13용 에 대한 정보사설 토토유형. 는 함수형 표현사설 토토parse그리고사설 토토직렬화다음으로 변환용 그리고 유형에서사설 토토여기서는 반복되지 않습니다. 이러한 기능 중 다수를 사용하려면 다음을 설치해야 합니다. 다음으로 구축됨구성 --with-lib사설 토토.

9.14.1. XML 콘텐츠 생성

함수 집합과 함수형 표현식은 다음과 같습니다. SQL 데이터에서 XML 컨텐츠를 생성하는 데 사용할 수 있습니다. 따라서, 쿼리 결과 형식을 지정하는 데 특히 적합합니다. 클라이언트 애플리케이션에서 처리하기 위해 XML 문서로 변환합니다.

9.14.1.1. 사설 토토comment

사설 토토comment(텍스트)

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

예:

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

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

9.14.1.2. 사설 토토concat

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

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

예:

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

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

XML 선언이 있는 경우 다음과 같이 결합됩니다. 만약에 모든 인수 값에는 동일한 XML 버전 선언이 있습니다. 해당 버전이 결과에 사용되며, 그렇지 않으면 버전이 사용되지 않습니다. 모든 인수 값이 독립형 선언 값을 갖는 경우"그렇습니다", 그러면 해당 값은 다음에서 사용됩니다. 결과. 모든 인수 값이 독립형인 경우 선언 값이 있고 적어도 하나는 다음과 같습니다."아니요"이면 결과에 사용됩니다. 그 외 결과에는 독립형 선언이 없습니다. 결과가 나오면 독립형 선언이 필요하다고 결정되었지만 버전 선언, 버전 1.0의 버전 선언 XML에는 XML 선언이 필요하기 때문에 사용됩니다. 버전 선언을 포함합니다. 인코딩 선언은 다음과 같습니다. 모든 경우에 무시되고 제거됩니다.

예:

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

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

9.14.1.3. 사설 토토요소

 사설 토토요소(이름이름 [, 사설 토토속성( [ASattname] [, ... ])] [, 내용, ...])

사설 토토요소표현 주어진 이름, 속성 및 내용.

예:

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. 는 개별 데이터 유형에 대한 특정 동작은 SQL 및 PostgreSQL 데이터 유형을 정렬하기 위해 발전 XML 스키마 사양을 사용하면 더 많은 정보를 얻을 수 있습니다. 정확한 설명이 나옵니다.

9.14.1.4. 사설 토토forest

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

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

예:

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

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

SELECT 사설 토토forest(table_name, column_name) FROM information_schema.columns 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표현식사설 토토요소.

9.14.1.5. 사설 토토pi

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

사설 토토pi표현식 생성 XML 처리 명령. 콘텐츠가 있는 경우 다음과 같아야 합니다. 문자 시퀀스를 포함하지 않습니다.?.

예:

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

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

9.14.1.6. 사설 토토root

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

사설 토토root표현 사설 토토 값의 루트 노드 속성을 변경합니다. 만약 버전이 지정되면 버전의 값이 대체됩니다. 선언, 독립형 값이 지정된 경우 독립형 선언의 값을 대체합니다.

SELECT 사설 토토root(사설 토토parse(document '<?사설 토토 version="1.1"?<contentabc</content'), 버전 '1.0', 독립 실행형 yes);

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

9.14.1.7. 사설 토토agg

사설 토토agg(사설 토토)

함수사설 토토agg이요, 여기에 설명된 다른 함수와 달리 집계 기능. 입력 값을 집계에 연결합니다. 함수 호출, 예를 들어사설 토토concat그렇습니다. 참조PostgreSQL : 문서 : 8.3 : 사설 토토 사이트 함수집계 함수에 대한 일반 정보입니다.

예:

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

현재 구현에서는 연결은 원칙적으로 정의되지 않습니다. 입력하기 다른 방식으로 정렬되는 값은 일반적으로 작동합니다. 그러나. 예를 들어, 위의 예에서 다음과 같이 할 수 있습니다. 다음과 같이 순서에 영향을 줍니다.

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

그러나 이 접근법은 모든 면에서 작동한다고 보장되지는 않습니다. 상황과 PostgreSQL의 모든 버전에서. 미래 PostgreSQL 버전은 아마도 추가 기능을 제공할 것입니다. 순서를 적절하게 제어하는 기능 (사설 토토agg(expr ORDER BY expr, expr, ...).

9.14.1.8. XML 술어

사설 토토IS 문서

표현식IS 문서인수 XML 값이 적절한 XML이면 true를 반환합니다. 문서, 그렇지 않은 경우 거짓(즉, 내용임) 조각) 또는 인수가 null인 경우 null입니다. 참조섹션 8.13차이점에 대해 문서와 콘텐츠 조각 사이

9.14.2. 처리 XML

데이터 유형의 값을 처리하려면사설 토토, PostgreSQL은 다음 기능을 제공합니다.xpath23417_23463

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

함수xpath평가하다 XPath 표현식xpath사설 토토 값에 반함사설 토토. 그것 노드 세트에 해당하는 XML 값의 배열을 반환합니다. XPath 표현식에 의해 생성됩니다.

함수의 세 번째 인수는 네임스페이스 배열입니다. 매핑. 이 배열은 다음을 포함하는 2차원 배열이어야 합니다. 두 번째 축의 길이는 2와 같습니다(즉, 배열의 배열, 각 배열은 정확히 2개로 구성됩니다. 요소). 각 배열 항목의 첫 번째 요소는 네임스페이스 이름, 두 번째는 네임스페이스 URI입니다.

예:

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

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

9.14.3. 테이블 매핑 대상 XML

다음 함수는 관계형 내용을 매핑합니다. 테이블을 XML 값으로 변환합니다. XML 내보내기로 생각할 수 있습니다. 기능.

table_to_사설 토토(tbl regclass, nulls boolean, tableforest boolean, targetns text)
query_to_사설 토토(쿼리 텍스트, nulls 부울, tableforest 부울, targetns 텍스트)
cursor_to_사설 토토(cursor refcursor, count int, nulls boolean, tableforest boolean, targetns text)

각 함수의 반환 유형은 다음과 같습니다사설 토토.

table_to_사설 토토컨텐츠를 매핑합니다. 명명된 테이블의 매개변수로 전달됨tbl.regclass유형 일반적인 표기법을 사용하여 테이블을 식별하는 문자열을 허용합니다. 선택적 스키마 한정 및 큰따옴표를 포함합니다.query_to_사설 토토쿼리를 실행합니다 텍스트가 매개변수로 전달됩니다.질의그리고 결과 세트를 매핑합니다.cursor_to_사설 토토표시된 개수를 가져옵니다. 매개변수로 지정된 커서의 행커서. 이 변형은 규모가 큰 경우 권장됩니다. 결과 값이 쌓이기 때문에 테이블을 매핑해야 합니다. 각 기능별로 메모리에 저장됩니다.

만약테이블포레스트거짓이면 결과 XML 문서는 다음과 같습니다.

<테이블 이름
  <행
    <columnname1데이터</columnname1
    <columnname2데이터</columnname2
  </row

  <행
    ...
  </row

  ...
</테이블 이름

만약테이블포레스트그렇습니다. 결과는 다음과 같은 XML 콘텐츠 조각입니다.

<테이블 이름
  <columnname1데이터</columnname1
  <columnname2데이터</columnname2
</테이블 이름

<테이블 이름
  ...
</테이블 이름

...

테이블 이름을 사용할 수 없는 경우, 즉 쿼리를 매핑할 때 또는 커서, 문자열테이블사용됨 첫 번째 형식에서는,두번째 형식.

이러한 형식 간의 선택은 사용자에게 달려 있습니다. 는 첫 번째 형식은 적절한 XML 문서이며 이는 중요합니다. 많은 응용 프로그램에서. 두 번째 형식이 더 유용한 경향이 있습니다. 에서cursor_to_사설 토토if 함수 결과 값은 나중에 하나의 문서로 재조립됩니다. 에. 위에서 설명한 XML 콘텐츠를 생성하는 기능은 다음과 같습니다. 특별한사설 토토요소일 수 있습니다. 맛에 맞게 결과를 변경하는 데 사용됩니다.

데이터 값은 다음에 대해 설명된 것과 동일한 방식으로 매핑됩니다. 함수사설 토토요소위.

매개변수결정합니다 null 값이 출력에 포함되어야 하는지 여부입니다. 사실이라면, 열의 null 값은 다음과 같이 표시됩니다.

<열 이름 xsi:nil="true"/

어디에서xsi은 사설 토토 네임스페이스입니다. 사설 토토 스키마 인스턴스의 접두사입니다. 적절한 네임스페이스 선언이 결과 값에 추가됩니다. 거짓인 경우, Null 값을 포함하는 열은 단순히 출력.

매개변수대상지정 결과의 원하는 사설 토토 네임스페이스. 특별한 것이 없다면 네임스페이스를 원하면 빈 문자열을 전달해야 합니다.

다음 함수는 XML 스키마 문서를 반환합니다 생성된 데이터 매핑에 의해 만들어진 매핑을 설명합니다. 위의 해당 기능.

table_to_사설 토토schema(tbl regclass, nulls 부울, tableforest 부울, targetns 텍스트)
query_to_사설 토토schema(쿼리 텍스트, nulls 부울, tableforest 부울, targetns 텍스트)
cursor_to_사설 토토schema(cursor refcursor, nulls boolean, tableforest boolean, targetns text)

동일한 매개변수가 순서대로 전달되는 것이 필수적입니다 일치하는 XML 데이터 매핑과 XML 스키마를 얻기 위해 문서.

다음 함수는 XML 데이터 매핑을 생성하고 하나의 문서(또는 포리스트)에 해당 XML 스키마가 연결되어 있음 함께. 독립적이고 독립적인 경우에 유용할 수 있습니다. 자기 설명적인 결과가 필요합니다.

table_to_사설 토토_and_사설 토토schema(tbl regclass, nulls 부울, tableforest 부울, targetns 텍스트)
query_to_사설 토토_and_사설 토토schema(쿼리 텍스트, nulls 부울, tableforest 부울, targetns 텍스트)

또한 다음 기능을 사용할 수 있습니다. 전체 스키마 또는 전체 스키마의 유사한 매핑을 생성합니다. 현재 데이터베이스.

schema_to_사설 토토(스키마 이름, nulls 부울, tableforest 부울, targetns 텍스트)
Schema_to_사설 토토schema(스키마 이름, nulls 부울, tableforest 부울, targetns 텍스트)
Schema_to_사설 토토_and_사설 토토schema(스키마 이름, nulls 부울, tableforest 부울, targetns 텍스트)

Database_to_사설 토토(nulls 부울, tableforest 부울, targetns 텍스트)
Database_to_사설 토토schema(nulls 부울, tableforest 부울, targetns 텍스트)
Database_to_사설 토토_and_사설 토토schema(nulls boolean, tableforest boolean, targetns text)

이들은 잠재적으로 많은 양의 데이터를 생성한다는 점에 유의하십시오. 메모리에 구축해야합니다. 콘텐츠를 요청할 때 대규모 스키마나 데이터베이스의 매핑을 수행하는 것이 좋습니다. 대신에 테이블을 별도로 매핑하는 것을 고려해보세요. 커서를 통해.

스키마 콘텐츠 매핑의 결과는 다음과 같습니다:

<스키마 이름

table1-매핑

table2-매핑

...

</스키마이름

테이블 매핑 형식은 다음에 따라 다릅니다.테이블포레스트설명된 매개변수 위.

데이터베이스 콘텐츠 매핑의 결과는 다음과 같습니다 이:

<데이터베이스 이름

<스키마1이름
  ...
</schema1name

<스키마2이름
  ...
</schema2name

...

</db이름

여기서 스키마 매핑은 위와 같습니다.

다음에 의해 생성된 출력을 사용하는 예로서 함수,그림 9-1다음의 출력을 변환하는 XSLT 스타일시트를 표시합니다.table_to_사설 토토_and_사설 토토schema에게 테이블 데이터의 테이블 형식 변환을 포함하는 HTML 문서입니다. 비슷한 방식으로, 이들 함수의 결과 데이터는 다음과 같습니다. 다른 XML 기반 형식으로 변환됩니다.

그림 9-1. 변환용 XSLT 스타일시트 SQL/사설 토토을 HTML로 출력

<?사설 토토 version="1.0"?
<xsl:스타일시트 버전="1.0"
    사설 토토ns:xsl="http://www.w3.org/1999/XSL/Transform"
    사설 토토ns:xsd="http://www.w3.org/2001/XMLSchema"
    사설 토토ns="http://www.w3.org/1999/xhtml"

  <xsl:출력 방법="사설 토토"
      doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"
      doctype-public="-//W3C/DTD XHTML 1.0 엄격//EN"
      들여쓰기="예"/

  <xsl:템플릿 일치="/*"
    <xsl:변수 이름="스키마" select="//xsd:스키마"/
    <xsl:변수 이름="테이블 유형 이름"
                  select="$schema/xsd:요소[@name=name(current())]/@type"/
    <xsl:변수 이름="행 유형 이름"
                  select="$schema/xsd:complexType[@name=$tabletypename]/xsd:sequence/xsd:element[@name='row']/@type"/

    <html
      <머리
        <title<xsl:value-of select="name(current())"/</title
      </head
      <본문
        <테이블
          <tr
            <xsl:for-each select="$schema/xsd:complexType[@name=$rowtypename]/xsd:sequence/xsd:element/@name"
              <th<xsl:value-of select="."/</th
            </xsl:for-each
          </tr

          <xsl:for-each select="행"
            <tr
              <xsl:for-each select="*"
                <td<xsl:value-of select="."/</td
              </xsl:for-each
            </tr
          </xsl:for-each
        </table
      </body
    </html
  </xsl:템플릿

</xsl:스타일시트