Documentdb-sql-string-functions

提供:Dev Guides
移動先:案内検索

DocumentDB SQL-文字列関数

文字列関数は、文字列の入力値に対して操作を実行し、文字列、数値、またはブール値を返します。 サポートされている組み込み文字列関数は次のとおりです。

S.No. Function & Description
1

LENGTH (str_expr)

指定された文字列式の文字数を返します。

2

CONCAT (str_expr, str_expr [, str_expr])

2つ以上の文字列値を連結した結果である文字列を返します。

3

SUBSTRING (str_expr, num_expr, num_expr)

文字列式の一部を返します。

4

STARTSWITH (str_expr, str_expr)

最初の文字列式が2番目で終わるかどうかを示すブール値を返します。

5

ENDSWITH (str_expr, str_expr)

最初の文字列式が2番目で終わるかどうかを示すブール値を返します。

6

CONTAINS (str_expr, str_expr)

最初の文字列式に2番目の式が含まれているかどうかを示すブール値を返します。

7

INDEX_OF (str_expr, str_expr)

最初に指定された文字列式内で2番目の文字列式が最初に現れる開始位置を返します。文字列が見つからない場合は-1を返します。

8

LEFT (str_expr, num_expr)

指定した文字数の文字列の左部分を返します。

9

RIGHT (str_expr, num_expr)

指定した文字数の文字列の右部分を返します。

10

LTRIM (str_expr)

先頭の空白を削除した後、文字列式を返します。

11

RTRIM (str_expr)

すべての末尾ブランクを切り捨てた後、ストリング式を返します。

12

LOWER (str_expr)

大文字の文字データを小文字に変換した後、文字列式を返します。

13

UPPER (str_expr)

小文字の文字データを大文字に変換した後、文字列式を返します。

14

REPLACE (str_expr, str_expr, str_expr)

指定した文字列値のすべての出現を別の文字列値に置き換えます。

15

REPLICATE (str_expr, num_expr)

文字列値を指定された回数繰り返します。

16

REVERSE (str_expr)

文字列値の逆順を返します。

いくつかの組み込み文字列関数が使用される例を見てみましょう。

ビルトイン文字列

以下は、さまざまな文字列関数を使用したクエリです。

SELECT
   CONCAT("There are ", "2", " items") AS StrConcat,
   CONTAINS("Abcdef", "cde") AS StrContains,
   STARTSWITH("Abcdef", "Ab") AS StrStartsWith,
   ENDSWITH("Abcdef", "cdef") AS StrEndsWith,

   INDEX_OF("Abcdef", "de") AS StrIndexOf1,
   INDEX_OF("Abcdef", "df") AS StrIndexOf2,

   LEFT("Abcdef", 3) AS StrLeft,
   RIGHT("Abcdef", 3) AS StrRight,

   SUBSTRING("Abcdef", 2, 3) AS StrSubstring,
   LENGTH("Abcdef") AS StrLength,
   LOWER("Abcdef") AS StrLower,
   UPPER("Abcdef") AS StrUpper

上記のクエリを実行すると、次の出力が生成されます。

[
   {
      "StrConcat": "There are 2 items",
      "StrContains": true,
      "StrStartsWith": true,
      "StrEndsWith": true,
      "StrIndexOf1": 3,
      "StrIndexOf2": -1,
      "StrLeft": "Abc",
      "StrRight": "def",
      "StrSubstring": "cde",
      "StrLength": 6,
      "StrLower": "abcdef",
      "StrUpper": "ABCDEF"
   }
]