토토 베이text(텍스트) →토토 베이

함수토토 베이text입력 인수를 컨텐츠로 포함하는 단일 텍스트 노드로 토토 베이 값을 반환합니다. Ampersand (와 같은 사전 정의 된 엔티티&), 왼쪽 및 직각 브래킷 (<) 및 따옴표 ("") 탈출.

예 :

토토 베이text ( '<foo & bar')를 선택합니다.
         토토 베이text
-----------------------------
 & lt; foo & amp; Bar & gt;

토토 베이comment(텍스트) →토토 베이

함수토토 베이comment지정된 텍스트를 컨텐츠로 포함하는 토토 베이 값을 포함하는 토토 베이 값을 만듭니다. 텍스트는 포함 할 수 없습니다“--”또는 a로 끝납니다.“-”, 그렇지 않으면 결과 구성은 유효한 토토 베이 주석이 아닙니다. 인수가 null이면 결과는 null입니다.

예 :

선택 토토 베이Comment ( 'Hello');

  토토 베이comment
--------------
 <!-안녕하세요-

토토 베이concat(토토 베이[, ...]) →토토 베이

함수토토 베이CONCAT토토 베이 컨텐츠 조각을 포함하는 단일 값을 생성하기 위해 개별 토토 베이 값의 목록을 연결합니다. 널 값은 생략됩니다. 결과는 unnull 인수가없는 경우에만 NULL입니다.

예 :

토토 베이CONCAT를 선택합니다 ( '<abc/', '<bar foo </bar');

      토토 베이concat
------------------------
 <ABC/ <bar foo </bar

토토 베이 선언은 현재 존재하는 경우 다음과 같이 결합됩니다. 모든 인수 값에 동일한 토토 베이 버전 선언이있는 경우 해당 버전이 결과에 사용되면 버전이 사용되지 않습니다. 모든 인수 값이 독립형 선언 값을 갖는 경우“예”, 그 값은 결과에 사용됩니다. 모든 인수 값이 독립형 선언 값을 가지고 있고 적어도 하나는입니다.“아니오”, 그런 다음 결과에 사용됩니다. 그렇지 않으면 결과에는 독립형 선언이 없습니다. 결과에 독립형 선언이 필요하지만 버전 선언이없는 경우 토토 베이에 버전 선언을 포함하기 위해 토토 베이 선언이 필요하기 때문에 버전 1.0이있는 버전 선언이 사용됩니다. 인코딩 선언은 모든 경우에 무시되고 제거됩니다.

예 :

토토 베이CONCAT를 선택하십시오 ( '<? 토토 베이 버전 = "1.1"? <foo/', '<? xml 버전 = "1.1"stockalone = "no"? <bar/');

             토토 베이concat
--------------------------------------
 <? xml 버전 = "1.1"? <foo/ <bar/

토토 베이element(이름 이름[, 토토 베이attributes(attvalue[ as attname ] [, ...])] [, 컨텐츠[, ...]]) →토토 베이

the토토 베이elementexpression은 주어진 이름, 속성 및 내용으로 토토 베이 요소를 생성합니다. 그만큼이름andattname구문에 표시된 항목은 값이 아닌 간단한 식별자입니다. 그만큼attvalueand컨텐츠항목은 표현이며, 이는 모든 것을 생산할 수 있습니다PostgreSQL데이터 유형. 내부의 논쟁토토 베이attributes토토 베이 요소의 속성 생성; 그만큼컨텐츠값은 내용을 형성하기 위해 연결되어 있습니다.

예 :

선택 XmlElement (이름 foo);

 토토 베이element
------------
 <foo/

토토 베이element (이름 foo, 토토 베이attributes ( 'xyz'as bar))를 선택하십시오.

    토토 베이element
-----------------
 <foo bar = "xyz"/

토토 베이element (이름 foo, 토토 베이attributes (current_date as bar), 'cont', 'ent')를 선택하십시오.

             토토 베이element
------------------------------------------------
 <foo bar = "2007-01-26" content </foo

유효하지 않은 요소 및 속성 이름 토토 베이 이름은 불쾌한 문자를 시퀀스로 바꾸어 빠져 나옵니다_XHHHH_, 여기HHHH| 예를 들어:

토토 베이ELEMENT를 선택합니다 (이름 "foo $ bar", 토토 베이ATTRIBUTES ( 'XYZ'로 "a & b"));

            토토 베이element
------------------------------------
 <foo_x0024_bar a_x0026_b = "xyz"/

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

테이블 테스트 생성 (토토 베이, B 토토 베이);
테스트에서 XmlElement (이름 테스트, Xmlattributes (a, b))를 선택하십시오.

그러나 이것은 다음과 같습니다.

토토 베이ELEMENT (이름 테스트, 토토 베이ATTRIBUTES ( 'constant'), a, b)를 선택하여 테스트;
XmlElement (이름 테스트, Xmlattributes (func (a, b)))를 테스트에서 선택하십시오;

요소 컨텐츠는 지정된 경우 데이터 유형에 따라 형식화됩니다. 내용 자체가 유형 인 경우토토 베이, 복잡한 토토 베이 문서를 구성 할 수 있습니다. 예를 들어:

토토 베이ELEMENT 선택 (이름 foo, 토토 베이attributes ( 'xyz'As bar),
                            토토 베이element (이름 ABC),
                            토토 베이comment ( '테스트'),
                            토토 베이element (name xyz));

                  토토 베이element
-----------------------------------------------------
 <foo bar = "xyz" <abc/ <!-테스트- <xyz/</foo

다른 유형의 내용은 유효한 토토 베이 문자 데이터로 형식화됩니다. 이것은 특히 문자 <,, & & & & & we가 엔티티로 변환 될 것임을 의미합니다. 이진 데이터 (데이터 유형BYTEA) 구성 매개 변수 설정에 따라 Base64 또는 Hex 인코딩에 표시됩니다.토토 베이binary. 개별 데이터 유형에 대한 특정 동작은 PostgreSQL 매핑을 SQL : 2006 이상에 지정된 것과 정렬하기 위해 진화 할 것으로 예상됩니다.섹션 D.3.1.3.

토토 베이forest(컨텐츠[ as 이름 ] [, ...]) →토토 베이

the토토 베이forestexpression은 주어진 이름과 내용을 사용하여 요소의 토토 베이 숲 (시퀀스)을 생성합니다. for토토 베이element, 각이름간단한 식별자 여야하고컨텐츠표현식은 데이터 유형을 가질 수 있습니다.

예 :

토토 베이FOREST ( 'ABC'는 foo, 123으로 막대로 123);

          토토 베이forest
---------------------------------
 <foo abc </foo <bar 123 </bar

토토 베이FOREST (table_name, column_name)를 선택하십시오.
information_schema.columns에서
여기서 table_schema = 'pg_catalog';

                                토토 베이forest
-------------------------------------------------------------------------------
 <table_name pg_authid </table_name <culns_name rolname </column_name
 <table_name pg_authid </table_name <culns_name rolsuper </column_name
 ...

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

유효하지 않은 요소 이름 토토 베이 이름이 표시된대로토토 베이element위. 마찬가지로, 컨텐츠 데이터가 유효한 토토 베이 컨텐츠를 만들기 위해 피해서 이미 유형이 아닌 한토토 베이.

토토 베이 포레스트가 유효하지 않다는 점에 유의하십시오. 하나 이상의 요소로 구성된 경우 토토 베이 문서가 있으므로 랩 래프에 유용 할 수 있습니다토토 베이forest표현토토 베이element.

토토 베이pi(이름 이름[, 컨텐츠 ]) →토토 베이

the토토 베이PIexpression은 토토 베이 처리 명령을 생성합니다. for토토 베이element, The이름간단한 식별자 여야하는 반면컨텐츠표현식은 데이터 유형을 가질 수 있습니다. 그만큼컨텐츠, 존재하는 경우, 문자 순서를 포함해서는 안됩니다?.

예 :

선택 토토 베이PI (이름 php, 'echo "hello world";');

            토토 베이PI
---------------------------------
 <? php echo "Hello World";?

토토 베이root(토토 베이, 버전텍스트|가치 없음[, StandalOne예|아니오|가치 없음]) →토토 베이

the토토 베이rootexpression은 토토 베이 값의 루트 노드의 특성을 변경합니다. 버전이 지정되면 루트 노드의 버전 선언의 값을 대체합니다. 독립형 설정이 지정되면 루트 노드의 독립형 선언의 값을 대체합니다.

토토 베이ROOT (토토 베이PARSE (Document '<? 토토 베이 버전 = "1.1"? <content ABC </content'),
               버전 '1.0', 독립형 예);

                토토 베이root
------------------------------------------
 <? xml 버전 = "1.0"standalone = "yes"?
 <content ABC </content

토토 베이agg(토토 베이) →토토 베이

함수토토 베이agg는 여기에 설명 된 다른 함수와 달리 집계 기능입니다. 입력 값을 집계 함수 호출에 연결합니다.토토 베이CONCAT는 단일 행의 표현식이 아닌 행에 걸쳐 발생한다는 점을 제외하고는 그렇습니다. 보다Postgresql: Tài liệu: 17: 9.21. Hàm tổ와이즈 토토 hợp집계 함수에 대한 추가 정보.

예 :

테이블 테스트 생성 (y int, x xml);
테스트 값에 삽입 (1, '<foo abc </foo');
테스트 값에 삽입 (2, '<bar/');
테스트에서 토토 베이agg (x)를 선택하십시오.
        토토 베이agg
------------------------
 <foo abc </foo <bar/

연결 순서를 결정하려면주문 by조항은 다음에 설명 된대로 집계 통화에 추가 될 수 있습니다섹션 4.2.7. 예를 들어:

테스트에서 토토 베이agg (x order by y desc)를 선택합니다.
        토토 베이agg
------------------------
 <bar/ <foo abc </foo

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

토토 베이agg (x)를 선택하십시오 (Y desc의 테스트 순서에서 선택 *) 탭;
        토토 베이agg
------------------------
 <bar/ <foo abc </foo

토토 베이 is document→부울

표현is document인수 토토 베이 값이 적절한 토토 베이 문서 인 경우 true를 반환합니다. 보다PostgreSQL : 문서 : 17 : 8.13. 스포츠 토토 베이 사이트 유형문서와 콘텐츠 조각의 차이에 대한 정보.

토토 베이 문서가 아님→부울

표현문서가 아님인수 토토 베이 값이 적절한 토토 베이 문서 인 경우 false를 반환합니다.

토토 베이exists(텍스트 통과[byRef|value]토토 베이[byRef|value]) →부울

함수토토 베이exists전달 된 토토 베이 값을 컨텍스트 항목으로 XPath 1.0 표현식 (첫 번째 인수)을 평가합니다. 해당 평가 결과가 빈 노드 세트를 생성하면 함수가 거짓을 반환합니다. 인수가 null이면 함수가 Null을 반환합니다. 컨텍스트 항목이 컨텐츠 조각 또는 토토 베이이 아닌 값이 아닌 토토 베이 문서 여야하지 않기 때문에 통과되지 않은 값이 없습니다.

예 :

토토 베이exists 선택 ( '// town [) =' '토론토' ']

 토토 베이exists
------------
 티
(1 행)

theby ref및value조항이 수락됩니다PostgreSQL, 그러나에서 논의 된 바와 같이 무시됩니다섹션 D.3.2.

SQL 표준에서토토 베이exists함수는 토토 베이 쿼리 언어의 표현식을 평가하지만PostgreSQL|섹션 D.3.1.

토토 베이_is_well_formed(텍스트) →부울
토토 베이_is_well_formed_document(텍스트) →부울
토토 베이_is_well_formed_content(텍스트) →부울

이 기능은 a를 확인합니다.텍스트스트링은 잘 형성된 토토 베이을 나타내며 부울 결과를 반환합니다.토토 베이_is_well_formed_document잘 형성된 문서를 확인하는 동안토토 베이_is_well_formed_content잘 형성된 콘텐츠를 확인하십시오.토토 베이_is_well_formed토토 베이option구성 매개 변수가 설정되었습니다문서또는 후자가 설정된 경우컨텐츠. 이것은토토 베이_is_well_formed간단한 캐스트가 입력 할 것인지 확인하는 데 유용합니다토토 베이성공할 것입니다. 다른 두 기능은 해당 변형이를 보는 데 유용합니다토토 베이PARSE성공할 것입니다.

예 :

Xmloption을 문서화하도록 설정;
토토 베이_is_well_formed ( '<')를 선택하십시오.
 토토 베이_is_well_formed
-------------------
 에프
(1 줄)

선택 토토 베이_is_well_formed ( '<abc/');
 토토 베이_is_well_formed
-------------------
 티
(1 줄)

토토 베이option을 컨텐츠로 설정하십시오.
선택 토토 베이_is_well_formed ( 'ABC');
 토토 베이_is_well_formed
-------------------
 티
(1 줄)

토토 베이_is_well_formed_document를 선택하십시오 ( '<pg : foo xmlns : pg = "http://postgresql.org/stuff" bar </pg : foo');
 토토 베이_is_well_formed_document
---------------------------------
 티
(1 줄)

토토 베이_is_well_formed_document를 선택하십시오 ( '<pg : foo xmlns : pg = "http://postgresql.org/stuff" bar </my : foo');
 토토 베이_is_well_formed_document
---------------------------------
 에프
(1 행)

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

xpath(xpath 텍스트, 토토 베이 토토 베이[, NSARRAY 텍스트 [] ]) →토토 베이 []

함수xpathXPath 1.0 표현식 평가xpath(토토 베이 값에 대한 텍스트)토토 베이. XPath 표현식에 의해 생성 된 노드 세트에 해당하는 토토 베이 값의 배열을 반환합니다. XPath 표현식이 노드 세트가 아닌 스칼라 값을 반환하면 단일 요소 어레이가 반환됩니다.

두 번째 인수는 잘 형성된 토토 베이 문서 여야합니다. 특히 단일 루트 노드 요소가 있어야합니다.

함수의 선택적 세 번째 인수는 네임 스페이스 매핑 배열입니다. 이 배열은 2 차원이어야합니다텍스트36808_37222xpath함수 컨텍스트, 별칭은로컬).

예 :

xpath ( '/my : a/text ()', '<my : a xmlns : my = "http://example.com" test </my : a',
             배열 [배열 [ 'my', 'http://example.com']);

 xpath
--------
 시험

기본 (익명) 네임 스페이스를 다루려면 다음과 같은 일을하십시오.

xpath ( '// mydefns : b/text ()', '<a xmlns = "http://example.com" <b 테스트 </b </a',
             배열 [배열 [ 'mydefns', 'http://example.com']);

 xpath
--------
 시험

xpath_exists(xpath 텍스트, 토토 베이 토토 베이[, NSARRAY 텍스트 [] ]) →부울

함수xpath_exists전문화 된 형태의xpath함수. XPath 1.0 표현식을 만족시키는 개별 토토 베이 값을 반환하는 대신,이 함수는 쿼리가 만족되었는지 여부를 나타내는 부울을 반환합니다 (특히 빈 노드 세트 이외의 값을 생성했는지 여부). 이 기능은와 같습니다.토토 베이exists네임 스페이스 매핑 인수에 대한 지원을 제공한다는 점을 제외하고는 술어.

예 :

xpath_exists를 선택하십시오 ( '/my : a/text ()', '<my : a xmlns : my = "http://example.com" test </my : a',
                     배열 [배열 [ 'my', 'http://example.com']);

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

토토 베이table(
    [ 토토 베이namespaces(네임 스페이스_URI as 네임 스페이스 _name[, ...]),]row_expression 통과[byRef|value]Document_Expression[byRef|value]열 이름타입[PATH Column_Expression] [기본값 default_expression] [NOT NULL | NULL]
                  |의식[, ...]
) →Setof Record

the토토 베이tableexpression 토토 베이 값, 행을 추출하는 XPath 필터 및 열 정의 세트를 기반으로 테이블을 생성합니다. 성적으로 함수와 유사하지만 쿼리의 테이블로만 나타날 수 있습니다.From절.

선택 사항토토 베이namespaces조항은 쉼표로 구분 된 네임 스페이스 정의 목록을 제공합니다.네임 스페이스_URIis텍스트표현 및 각네임 스페이스 _name는 간단한 식별자입니다. 문서에 사용 된 토토 베이 네임 스페이스 및 해당 별칭을 지정합니다. 기본 네임 스페이스 사양은 현재 지원되지 않습니다.

필수row_expression인수는 XPath 1.0 표현식입니다 (as텍스트) 평가 된 토토 베이 값을 전달Document_Expression컨텍스트 항목으로서 토토 베이 노드 세트를 얻습니다. 이 노드는 무엇입니다토토 베이table출력 행으로 변환합니다. 이면 행이 생성되지 않습니다.Document_Expressionrow_expression빈 노드 세트 또는 노드 세트 이외의 값을 생성합니다.

Document_Expression컨텍스트 항목 제공row_expression. 잘 형성된 토토 베이 문서 여야합니다. 조각/숲은 허용되지 않습니다. 그만큼refandvalue조항은 받아 들여 지지만 무시됩니다.섹션 D.3.2.

SQL 표준에서토토 베이table함수는 토토 베이 쿼리 언어의 표현식을 평가하지만PostgreSQL섹션 D.3.1.

필수열절은 출력 테이블에서 생성 될 열을 지정합니다. 형식은 위의 구문 요약을 참조하십시오. 데이터 유형과 마찬가지로 각 열에 이름이 필요합니다 (의식지정되어 있으며,이 경우 유형정수암시 적입니다). 경로, 기본 및 무효 조항은 선택 사항입니다.

표시된 열의식|에서 검색 한 노드의 순서대로 1로 시작하여 행 번호로 채워집니다.row_expression의 결과 노드 세트. 최대 하나의 열이 표시 될 수 있습니다의식.

thecolumn_expression열의 경우 각 행에 대해 평가되는 XPath 1.0 표현식이며row_expression열의 값을 찾기 위해 컨텍스트 항목으로 결과. 그렇지 않은 경우column_expression가 주어지면 열 이름은 암시 적 경로로 사용됩니다.

열의 XPath 표현식이 비 토토 베이 값 (XPATH 1.0에서 String, Boolean 또는 Double으로 제한됨)을 반환하는 경우 열에는 이외의 PostgreSQL 유형이 있습니다.토토 베이, 열은 값의 문자열 표현을 PostgreSQL 유형에 할당하여 설정됩니다. (값이 부울 인 경우, 문자열 표현이 필요합니다1또는0출력 열 유형 카테고리가 숫자 인 경우true또는false.)

열의 XPath 표현식이 비어 있지 않은 토토 베이 노드 세트를 반환하고 열의 PostgreSQL 유형이입니다.토토 베이, 문서 또는 내용 형식 인 경우 열에 표현식 결과가 정확히 할당됩니다.^[8]

토토 베이이 아닌 결과토토 베이출력 열은 결과의 문자열 값을 가진 단일 텍스트 노드 인 컨텐츠를 생성합니다. 다른 유형의 열에 할당 된 토토 베이 결과는 둘 이상의 노드가 없거나 오류가 발생할 수 있습니다. 정확히 하나의 노드가있는 경우 노드의 문자열 값을 할당하여 열이 설정됩니다 (XPath 1.0에 대해 정의 된대로String함수) PostgreSQL 유형으로.

토토 베이 요소의 문자열 값은 해당 요소와 그 후손에 포함 된 모든 텍스트 노드의 문서 순서로 연결입니다. 후손 텍스트 노드가없는 요소의 문자열 값은 빈 문자열입니다 (아님NULL). 어느XSI : NIL속성은 무시됩니다. 공백 전용text ()텍스트가 아닌 두 가지 요소 사이의 노드가 보존되고text ()노드는 평평하지 않습니다. XPath 1.0String다른 토토 베이 노드 유형의 문자열 값과 비 토토 베이 값을 정의하는 규칙에 대해 함수를 참조 할 수 있습니다.

여기에 제시된 전환 규칙은 SQL 표준의 규칙이 아닙니다.섹션 D.3.1.3.

경로 표현식이 빈 노드 세트를 반환하면 주어진 행에 대해 열이로 설정됩니다.NULLdefault_expression지정되어 있습니다. 그런 다음 표현식을 평가하여 발생하는 값이 사용됩니다.

adefault_expression토토 베이table호출되면 열에 대한 기본값이 필요할 때마다 평가됩니다. 표현이 안정적이거나 불변으로 자격이있는 경우 반복 평가를 건너 뛸 수 있습니다. 이것은 당신이 |와 같은 휘발성 기능을 유용하게 사용할 수 있음을 의미합니다.NextValindefault_expression.

열이 표시 될 수 있습니다NOT NULL. 인 경우column_expressionaNOT NULL열은 아무것도 일치하지 않으며 없습니다기본값또는default_expression또한 NULL로 평가하면 오류 가보고됩니다.

예 :

테이블 xmldata를 선택하여 작성하십시오
xml $$
<줄
  <row id = "1"
    <country_id au </country_id
    <country_name 호주 </country_name
  </row
  <row id = "5"
    <country_id jp </country_id
    <country_name 일본 </country_name
    <premier_name Shinzo Abe </premier_name
    <size init = "sq_mi" 145935 </size
  </row
  <row id = "6"
    <country_id sg </country_id
    <country_name 싱가포르 </country_name
    <size init = "sq_km" 697 </size
  </row
</rows
데이터로서 $$;

토토 베이table을 선택하십시오.*
  토토 베이DATA에서
       토토 베이table ( '// 행/행'
                전달 데이터
                열 INT int path '@id',
                        의식을위한 의식,
                        "Country_Name"텍스트,
                        Country_id 텍스트 경로 'Country_id',
                        size_sq_km float path 'size [@unit = "sq_km"]',
                        size_other 텍스트 경로
                             'concat (size [@unit! = "sq_km"], "", size [@unit! = "sq_km"/@init)',
                        premier_name 텍스트 경로 'premier_name'default 'not windified');

 id | 의식 | Country_Name | Country_id | size_sq_km |  size_other | premier_name
----+------------+--------------------------------------------------------------------------------------------------------------
  1 |          1 | 호주 | au |            |              | 지정되지 않았습니다
  5 |          2 | 일본 | JP |            | 145935 SQ_MI | 신조 아베
  6 |          3 | 싱가포르 | sg |        697 |              | 지정되지 않음

다음 예제는 여러 텍스트 () 노드의 연결, XPATH 필터로 열 이름 사용 및 흰색 표지, 토토 베이 주석 및 처리 지침의 처리를 보여줍니다 :

테이블 토토 베이ELEMENTS를 선택하여 작성하십시오
xml $$
  <루트
   <ementt hello <!-xyxxz- 2a2 <? aaaaa? <!-x- bbb <xxx </x cc </element
  </root
데이터로서 $$;

토토 베이table을 선택하십시오.*
  xmlElements, 토토 베이table ( '/root'데이터 열 전달 요소 텍스트);
         요소
-----------------------------
   Hello2A2 BBBXXXCC

다음 예제는를 보여줍니다.토토 베이namespaces절을 사용하여 토토 베이 문서와 XPath 표현식에 사용되는 네임 스페이스 목록을 지정할 수 있습니다.

xmldata (data) as (value ( ')
<예제 xmlns = "http://example.com/myns"xmlns : b = "http://example.com/b"
 <item foo = "1"b : bar = "2"/
 <item foo = "3"b : bar = "4"/
 <item foo = "4"b : bar = "5"/
</example ':: xml)
))
토토 베이table을 선택하십시오.*
  토토 베이table에서 (토토 베이namespaces ( 'http://example.com/myns'로 x,
                              'http://example.com/b'as "b"),
             '/x : 예/x : 항목'
                통과 (토토 베이DATA에서 데이터 선택)
                열 foo int path '@foo',
                  bar int path '@b : bar');
 foo | 술집
-----+-----
   1 |   2
   3 |   4
   4 |   5
(3 줄)