- ベストアンサー
論理名とコメント構文について
- 論理名とは、日本語表記で内容を分かりやすくするための名称です。主にテーブル定義書やSQLの中で使用されます。
- 論理名はMySQLのコメント内に記述することもできます。
- コメント構文とCOMMENTオプションは、SQLステートメントの構文解析に適用されます。コメントはテーブルのカラムにも付けることができます。
- みんなの回答 (1)
- 専門家の回答
質問者が選んだベストアンサー
■コメント ★「コメント構文」と、「COMMENT オプション」の違い 「コメント構文」は、SQL文を書く上でのコメントの書き方。 処理の結果に対する影響はありません。 「COMMENT オプション」は、テーブルの情報の一つ。 処理の結果、テーブルの情報として書き込まれるため、 SHOW CREATE TABLE と SHOW FULL COLUMNS ステートメントによっていつでも表示できます。 例 create table table1 /* 日付と文字列各1個の定義をします */ (col1 date COMMENT '日付です', col2 VARCHAR(10) COMMENT '文字列です' ) SHOW CREATE TABLE と SHOW FULL COLUMNSをすると、 COMMENT の定義は出てくるけど、/* ・・・ */の内容はでてこない。 ## 今手元にMySQLの環境がないので未検証です。 ■論理名 >・論理名は、内容を分かりやすくするために付ける日本語表記、と思っているのですが、 >そういう認識で合っているでしょうか? いいと思います。 他には、すべて論理名で仕様を作成して実装直前で物理名と紐付けするような開発方法をすると ちょっと違うイメージになるかも。 (内容を分かりやすくするためではテーブル上の項目に同一論理名を複数つけても問題ないが、 論理名で仕様を作成するなら、テーブル上の項目に同一論理名を複数つけてはいけない!) >・論理名は、どこに付けるのでしょうか? >テーブル定義書などの設計書にだけ表記するのでしょうか? >それとも、SQLの中で「論理名」を付ける場所は決まっているのでしょうか? 設計書だけでもOK。 既述のコメントオプションやコメント構文のいづれの方法で各コメントに記載してもOK。 開発のルールしだい。 >・MySQLのコメント内に、「論理名」を記述しても良いのでしょうか? かまいませんし、一般にはコメントに論理名を記述することは少なくないです。 (手間がかかるので一切省くという場合もありますけど。) >・「論理名」を付与する場合、一般的に、どこに記述するのか? >SQLの中でも記述するのか? について、教えてください 仕様書だけの場合もあれば、SQLのコメントまでの場合もあれば、 テーブルのCommentオプションまで書く場合もあります。 私の場合は、仕様書だけのことが多いかな。 (内部設計書を見ると、SQLや関数はすべて知っている前提で 何も考えなくてもSQLを含む、各言語のプログラムソースが書けるレベルにしているので・・・ というか、プログラムソースの一部分を見て、内部設計書のどこの部分かわからないソースには していないからというべきか。 ・・・項目名のつけ方が、tblACol1,tblAcol2,・・・ とかと決まっていたならコメントつけたほうがいいかも)
お礼
回答内容が、丁寧で大変分かりやすかったです。 おかげで疑問が解消しました! ありがとうございましたー