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定義でサポートされている関数式は以下の表のとおりです。