# データベース呼び出しとシステムに関するセマンティック規約

> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/db/


**ステータス**: [Mixed][DocumentStatus]

この文書では、データベースクライアントのスパンに関するセマンティック規約に加え、データベースのメトリクスとログに関するセマンティック規約を定義します。

> [!IMPORTANT]
>
> [この文書のv1.24.0](https://github.com/open-telemetry/semantic-conventions/blob/v1.24.0/docs/database/database-spans.md)
> 以前のバージョンを使っている既存のデータベース計装は、次に従うべきです。
>
> * 既存のメジャーバージョンにおいて、デフォルトで発行するデータベース規約のバージョンを変更してはなりません（SHOULD NOT）。
>   規約には、属性、メトリクス名、スパン名、計測単位などが含まれますが、これらに限定されません。
> * 既存のメジャーバージョンにおいて、カテゴリー別の値をカンマ区切りで列挙するリストとして環境変数 `OTEL_SEMCONV_STABILITY_OPT_IN` を導入すべきです（SHOULD）
>   （例: http、databases、messaging）。値の一覧は次のとおりです。
>   * `database` - 安定版のデータベース規約を発行し、それまで計装が発行していた実験的なデータベース規約の発行を停止します。
>   * `database/dup` - 実験的な規約と安定版の規約の両方を発行し、安定版セマンティック規約への段階的な移行を可能にします。
>   * これらの値がいずれも指定されていない場合のデフォルトの動作は、その計装がそれまで発行していた実験的なデータベース規約のバージョンをそのまま発行し続けることです。
>   * 注記: 両方の値が指定されている場合、`database/dup` は `database` よりも優先されます。
> * 両方の規約セットを発行し始めてから少なくとも6か月間は、既存のメジャーバージョンを（少なくともセキュリティパッチの適用という形で）維持すべきです（SHOULD）。
> * 次のメジャーバージョンでは、この環境変数を削除し、安定版のデータベース規約のみを発行してもかまいません（MAY）。

データベース操作に関するセマンティック規約は、次のシグナルについて定義されています。

* [DB Spans](./database-spans/): データベースクライアントの*スパン*に関するセマンティック規約。
* [DB Metrics](./database-metrics/): データベース操作の*メトリクス*に関するセマンティック規約。
* [DB Exceptions](./database-exceptions/): データベースクライアントの*例外*に関するセマンティック規約。

技術固有のセマンティック規約は、次のデータベースについて定義されています。

* [AWS DynamoDB](./dynamodb/): *AWS DynamoDB*に関するセマンティック規約。
* [Cassandra](./cassandra/): *Cassandra*に関するセマンティック規約。
* [Azure Cosmos DB](./cosmosdb/): *Azure Cosmos DB*に関するセマンティック規約。
* [CouchDB](./couchdb/): *CouchDB*に関するセマンティック規約。
* [Elasticsearch](./elasticsearch/): *Elasticsearch*に関するセマンティック規約。
* [HBase](./hbase/): *HBase*に関するセマンティック規約。
* [MongoDB](./mongodb/): *MongoDB*に関するセマンティック規約。
* [Microsoft SQL Server](./sql-server/): *Microsoft SQL Server*に関するセマンティック規約。
* [Oracle Database](./oracledb/): *Oracle Database*に関するセマンティック規約。
* [Redis](./redis/): *Redis*に関するセマンティック規約。
* [SQL](./sql/): *SQL*データベースに関するセマンティック規約。

[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status

- [データベースクライアントのスパンに関するセマンティック規約](/works/otel-specs-ja/semconv/db/database-spans/)
- [データベースクライアントのメトリクスに関するセマンティック規約](/works/otel-specs-ja/semconv/db/database-metrics/)
- [データベース例外に関するセマンティック規約](/works/otel-specs-ja/semconv/db/database-exceptions/)
- [Cassandraに関するセマンティック規約](/works/otel-specs-ja/semconv/db/cassandra/)
- [Azure Cosmos DBに関するセマンティック規約](/works/otel-specs-ja/semconv/db/cosmosdb/)
- [CouchDBに関するセマンティック規約](/works/otel-specs-ja/semconv/db/couchdb/)
- [AWS DynamoDBに関するセマンティック規約](/works/otel-specs-ja/semconv/db/dynamodb/)
- [Elasticsearchクライアント操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/elasticsearch/)
- [HBaseクライアント操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/hbase/)
- [MariaDBクライアント操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/mariadb/)
- [MongoDBクライアント操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/mongodb/)
- [MySQLクライアント操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/mysql/)
- [Oracle Databaseに関するセマンティック規約](/works/otel-specs-ja/semconv/db/oracledb/)
- [PostgreSQLに関するセマンティック規約](/works/otel-specs-ja/semconv/db/postgresql/)
- [Redisクライアントの操作に関するセマンティック規約](/works/otel-specs-ja/semconv/db/redis/)
- [SQLデータベースに関するセマンティック規約](/works/otel-specs-ja/semconv/db/sql/)
- [Microsoft SQL Serverに関するセマンティック規約](/works/otel-specs-ja/semconv/db/sql-server/)