XMLデータ定義

XML構文

OceanBaseデータベースの現在のバージョンは、Extensible Markup Language（XML）1.0構文をサポートしていますが、XMLSchemaや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" が含まれ、さらに2つの子要素 <title> と <author> を含みます。子要素は正しくネストする必要があります。空要素の場合、例えば <tag></tag> のように、省略形である <tag/> を使用できます。

XMLドキュメント内容では <> や引用符などの識別子が使用されているため、内容に特殊な記号が含まれる場合は、&???; を使用してエスケープする必要があります。例えば、Java<tm> は name という名前の子要素として、<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定義でサポートされている関数式は、次の表のとおりです。