XMLデータ定義

XML構文

OceanBaseデータベースの現行バージョンは、Extensible Markup Language（XML）1.0構文をサポートしていますが、XML SchemaやDTDはサポートしていません。 XMLドキュメントは主にステートメント宣言とドキュメント内容の2つの部分で構成されており、ドキュメント内容部分には通常、要素、属性、コメント、エスケープ文字、処理命令などが含まれます。

XMLステートメント宣言には固定された構造があります。例えば<?xml version="1.0"?>です。XMLドキュメント内容には、ルート要素が1つだけ存在し、そのルート要素には任意の数の子要素を含めることができます。また、要素には属性を含めることができます。例えば<book isbn="123-456-789">...<title>mybook</title><author>Alex</author></book>には、isbn="123-456-789"という属性が含まれており、同時に<title>と<author>という2つの子要素が含まれています。子要素は正しくネストする必要があります。空要素の場合、例えば<tag></tag>のように、省略形で<tag/>と表記できます。

XMLドキュメント内容では<>や引用符などの識別子が使用されているため、内容に特殊な記号が含まれる場合は、&???;を使用してエスケープする必要があります。例えば、Java<tm>という名前の子要素は、<name>Java&lt;tm&gt;</name>としてエスケープされます。XML 1.0に組み込まれているエスケープ記号は以下の表のとおりです。

XMLドキュメントでは、ネームスペースnamespaceを定義して命名衝突を回避できます。namespaceを定義する構文は以下のとおりです：

xmlns:namespace-prefix="namespaceURI"

以下の例では、2種類のテーブル定義が存在するため、namespaceを使用して区別する必要があります。"http://www.example1.org/TR/html4/"と"http://www.example2.com.cn/furniture"は、ネームスペースを示すアドレスとして使用され、ネームスペースに一意の名前を付与する役割を果たします。

<doc>
  <h:table xmlns:h="http://www.example1.org/TR/html4/">
    <h:tr>
      <h:td>Apples</h:td>
      <h:td>Bananas</h:td>
    </h:tr>
  </h:table>
  <f:table xmlns:f="http://www.example2.com.cn/furniture">
    <f:name>African Coffee Table</f:name>
    <f:width>80</f:width>
    <f:length>120</f:length>
  </f:table>
</doc>

注意が必要な点として、ネームスペースが要素の開始タグ内で定義されている場合、同じプレフィックスを持つすべての子要素は同一のネームスペースに関連付けられます。

XPath

XPath（XML Path Language）は、XMLドキュメント内の特定の要素を位置特定するために使用される言語であり、EXTRACT、UPDATEXML などの式で使用できます。

XMLドキュメント自体は、要素ノード、属性ノード、テキストノードなどを含むノードツリーと見なすことができます。XPathは、データ構造ツリー内でノードを検索する機能を提供し、クエリ結果はノードセット（重複しないノードの無順序集合）、ブール値（TrueまたはFalse）、数値、または文字列になり得ます。

XPathの完全な構文は以下のとおりです。各Location Nodeは / で区切られ、最初のNodeでは / を省略できます。

/axis::nodetest()

以下の具体的な例を通じて、XPath構文について詳しく説明します。

/descendant::a，/child::text()

上記の例では：

• descendant-or-self::para：現在のノードとそのすべての子孫の para 要素を選択します。

• self::para：現在のノードの para 要素を選択します。存在しない場合は NULL を返します。

• child::*/child::para：まず現在のノードのすべての子要素を選択し、その子ノードの para 要素を引き続き検索します。

• /：ルートノードを選択します。

ロケーター（Location Steps）

XPathはロケーターを使用してXMLドキュメント内のノードを選択します。

OceanBaseデータベースがサポートするロケーター情報は以下の表に示されています。

アクシス（Axes）

アクシスは現在のノードを原点とし、XPathのクエリ方向を示します。

OceanBaseデータベースがサポートするアクシスは以下の表に示されています（そのうちchildがデフォルトのアクシスです）。

以下の表はアクシス関連の例です。

ノードテスト（Node Tests）

ノードセットはアクシス情報と組み合わせてXPathのクエリ内容を指定し、デフォルトはelementです。

OceanBaseデータベースがサポートするノードセットは以下の表に示されています。

述語（Predicates）

述語は、特定のノードまたは指定された値を含むノードを検索するために使用されます。

OceanBaseデータベースがサポートする述語の例は以下の表に示されています。

ワイルドカード

XPathのワイルドカードは、任意のXML要素を選択するために使用できます。

OceanBaseデータベースがサポートするワイルドカードは以下の表に示されています。

以下の表は、ワイルドカードに関する例です。

演算子

OceanBaseデータベースのXPath式でサポートされる演算子は以下の表に示されています。

関数式

OceanBaseデータベースの現行バージョンのXPath定義でサポートされる関数式は以下の表に示されています。