翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# スカラー関数
<a name="sql-functions-scalar"></a>

 スカラー関数は 1 つ以上の入力値を取得し、1 つの出力値を返します。データ操作と取得のために SQL (構造化クエリ言語) で広く使用されており、データ処理タスクの効率が向上します。

**Topics**
+ [Null データ関数](sql-functions-null.md)
+ [文字列関数](sql-functions-string.md)
+ [数学関数](sql-functions-math.md)
+ [日時関数](sql-functions-date.md)
+ [型変換関数](sql-functions-type-conv.md)

# Null データ関数
<a name="sql-functions-null"></a>

 NULL データ関数は、値がないことを表す NULL 値を処理または操作します。関数を使用すると、NULLs他の値に置き換えたり、値が NULL であるかどうかを確認したり、特定の方法で NULLsを処理するオペレーションを実行したりできます。


|  **関数**  |  **署名**  |  **説明**  | 
| --- | --- | --- | 
|  `COALESCE`  |   COALESCE (expression1、expression2、...、expressionN)   |  すべての式が null と評価された場合、COALESCE は null を返します。式は同じタイプである必要があります。  | 

**Example COALESCE 関数の**  

```
SELECT COALESCE (l.double_value, 100) AS non_double_value FROM latest_value_time_series AS l LIMIT 1
```

# 文字列関数
<a name="sql-functions-string"></a>

 文字列関数は、テキストデータの操作と処理に使用される組み込みツールです。これにより、連結、抽出、フォーマット、文字列内の検索などのタスクが有効になります。これらの関数は、データベース内のテキストベースのデータのクリーニング、変換、分析に不可欠です。


**文字列関数**  

|  **関数**  |  **署名**  |  **説明**  | 
| --- | --- | --- | 
|  `LENGTH`  |   長さ (文字列)   |  文字列の長さを返します。  | 
|  `CONCAT`  |   CONCAT (文字列、文字列)   |  文字列内の引数を連結します。  | 
|  `SUBSTR`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-string.html)  |  次のいずれかを返します。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-string.html) 開始パラメータに 1 ベースのインデックス作成を使用します。  | 
|  `UPPER`  |   UPPER (文字列)   |  入力文字列の文字を大文字に変換します。  | 
|  `LOWER`  |   LOWER (文字列)   |  入力文字列の文字を小文字に変換します。  | 
|  `TRIM`  |   TRIM (文字列)   |  文字列の先頭、末尾、または両側からスペース文字を削除します。  | 
|  `LTRIM`  |   LTRIM (文字列)   |  文字列の先頭からスペース文字を削除します。  | 
|  `RTRIM`  |   RTRIM (文字列)   |  文字列の末尾からスペース文字を削除します。  | 
|  `STR_REPLACE`  |   STR\$1REPLACE (文字列、 から へ)   |  指定された部分文字列のすべての出現を、指定された別の部分文字列に置き換えます。  | 

すべての 関数の例:


|  **関数**  |  **例**  | 
| --- | --- | 
|  LENGTH  |  `SELECT LENGTH(a.asset_id) AS asset_id_length FROM asset AS a`  | 
|  CONCAT  |   `SELECT CONCAT(p.property_id, p.property_name) FROM asset_property AS p`   | 
|  SUBSTR  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-string.html)  | 
|  UPPER  |   `SELECT UPPER(d.string_value) AS up_string FROM raw_time_series AS d`   | 
|  LOWER  |   `SELECT LOWER(d.string_value) AS low_string FROM raw_time_series AS d`   | 
|  TRIM  |   `SELECT TRIM(d.string_value) AS tm_string FROM raw_time_series AS d`   | 
|  LTRIM  |   `SELECT LTRIM(d.string_value) AS ltrim_string FROM raw_time_series AS d`   | 
|  RTRIM  |   `SELECT RTRIM(d.string_value) AS rtrim_string FROM raw_time_series AS d`   | 
|  STR\$1REPLACE  |   `SELECT STR_REPLACE(d.string_value, 'abc', 'def') AS replaced_string FROM raw_time_series AS d`   | 

## 連結演算子
<a name="sql-operators-concatenation"></a>

 連結演算子 `||`またはパイプ演算子 は、2 つの文字列を結合します。`CONCAT` 関数の代わりに使用でき、複数の文字列を組み合わせると読みやすくなります。

**Example 連結演算子の**  

```
SELECT a.asset_name || ' - ' || p.property_name 
  AS full_name
  FROM asset a, asset_property p
```

# 数学関数
<a name="sql-functions-math"></a>

 数学関数は、SQL クエリ内で数値データの計算を実行するために使用される事前定義された数学演算です。これらは、データベースからデータを抽出して個別に処理することなく、データを操作および変換する方法を提供します。


**数学関数**  

|  **関数**  |  **署名**  |  **説明**  | 
| --- | --- | --- | 
|  `POWER`  |  POWER (int\$1double、int\$1double)  |  2 番目の引数の累乗に上げられた最初の引数の値を返します。  | 
|  `ROUND`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-math.html)  |  最も近い整数に丸めます。  | 
|  `FLOOR`  |   FLOOR (int\$1double)   |  指定された値以下の最大の整数を返します。  | 

すべての 関数の例:


|  **関数**  |  **例**  | 
| --- | --- | 
|  POWER  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-math.html)  | 
|  ROUND  |   `ROUND (32.12435, 3)`   | 
|  FLOOR  |   `FLOOR (21.2)`   | 

# 日時関数
<a name="sql-functions-date"></a>

 日付時刻関数は、日付と時刻で機能します。これらの関数を使用すると、日付の特定コンポーネントを抽出し、計算を実行し、日付値を操作できます。

これらの関数で許可される識別子は次のとおりです。
+ YEAR
+ MONTH
+ DAY
+ HOUR
+ MINUTE
+ SECOND


|  **関数**  |  **署名**  |  **説明**  | 
| --- | --- | --- | 
|  `NOW`  |   NOW ()   |  ミリ秒の精度で現在のタイムスタンプを返します。これは、クエリ内で実行された時点の正確な時間を提供します。  | 
|  `DATE_ADD`  |  DATE\$1ADD (識別子、間隔\$1期間、列)  |  日付/時刻と日数/時間、または日付/時刻と日付/時間間隔の合計を返します。  | 
|  `DATE_SUB`  |  DATE\$1SUB (識別子、間隔\$1期間、列)  |  日付/時刻と日数/時間の差、または日付/時刻と日付/時間間隔の差を返します。  | 
|  `TIMESTAMP_ADD`  |  TIMESTAMP\$1ADD (識別子、間隔\$1期間、列)  |  指定された時間単位の時間間隔を日時式に追加します。  | 
|  `TIMESTAMP_SUB`  |  TIMESTAMP\$1SUB (識別子、間隔\$1期間、列)  |  指定された時間単位の時間間隔を日時式から減算します。  | 
|  `CAST`  |  CAST (式 AS TIMESTAMP FORMAT パターン)  |  指定された形式パターンを使用して、文字列式をタイムスタンプに変換します。一般的なパターンには、標準の日時形式`'yyyy-MM-dd HH:mm:ss'`が含まれます。例: `SELECT CAST('2023-12-25 14:30:00' AS TIMESTAMP) AS converted_timestamp`  | 

**Example リストされた関数を使用した SQL クエリの :**  

```
SELECT r.asset_id, r.int_value,
  date_add(DAY, 7, r.event_timestamp) AS date_in_future,
  date_sub(YEAR, 2, r.event_timestamp) AS date_in_past,
  timestamp_add(DAY, 2, r.event_timestamp) AS timestamp_in_future,
  timestamp_sub(DAY, 2, r.event_timestamp) AS timestamp_in_past,
  now() AS time_now
FROM raw_time_series AS r
```

# 型変換関数
<a name="sql-functions-type-conv"></a>

 型変換関数は、値のデータ型をある値から別の値に変更するために使用されます。データの互換性を確保し、特定の形式のデータを必要とするオペレーションを実行するために不可欠です。


|  **関数**  |  **署名**  |  **説明**  | 
| --- | --- | --- | 
|  `TO_DATE`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 
|  `TO_TIMESTAMP`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 
|  `TO_TIME`  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 
|  `CAST`  |  CAST (<式> AS <データ型>)  |  エンティティ、または評価される式を 1 つの型から別の型に変換します。 サポートされているデータ型は次のとおりです。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/iot-sitewise/latest/userguide/sql-functions-type-conv.html)  | 

**Example リストされた関数を使用した SQL クエリの :**  

```
SELECT TO_TIMESTAMP (100) AS timestamp_value,
  TO_DATE(r.event_timestamp) AS date_value,
  TO_TIME(r.event_timestamp) AS time_value
FROM raw_time_series AS r
```