sql >> データベース >  >> RDS >> Mysql

MySQLでコメント機能を最大限に活用する方法

    コメントは、コードに情報を追加するために使用されます。コンパイラーはほとんど無視しますが、人間の専門家はコードを表示するときにそれらのコメントを読むことができます。コメントは時間に限りがあるため、開発者にとって不可欠です。コメントを使用すると、貴重な情報を一度に取得したり、コードに関する重要な詳細をメモしたりできます。このデータにアクセスすることで、彼らは正しい決定を下し、より迅速に作業することができます。

    コメントは私にとってどのように役立ちますか?

    コメントは、個人的にも、後でこのコードを読んだり編集したりする必要がある人にとっても役立ちます。しかし、どの程度正確ですか?

    • コメントは、コーディング時にプレースホルダーにすることができます。その瞬間、あなたは何かを仮定するかもしれません、そしてあなたはあなたの仮定が将来真実であるかどうかを知っているでしょう。
    • コメントは、自分の考えを文書化したり、自分自身のメモにしたりできるため、後で戻ってきたときに自分の行動を忘れることはありません。
    • 他のプログラマーがコードをよりよく、より速く理解できるように、コードに行ったことに関するコメントを含めることができます(コーダーの時間は非常に高くつきます)。
    • コメントを使用して、バグのある部分を一時的に無効または有効にすることができます。
    • スクリプトの各行にコメントを付けると、プログラム内のどこにバグがあるかを簡単に追跡できます。
    • コメントは、コードの特定の行が何をしているのか、または誤解を避けるために特定のアプローチを選択した理由を説明できます(たとえば、コードの一部が特定のセクションまたは明確に理解する必要がある特定の目的を目的としている場合) 、
    • 初心者や他のプロジェクトの人々に必要な場合は、コードセクションに関するすべての詳細を説明する段落全体を書くことができます。 INNER JOIN、GROUPBYなどの多くの句を含む複雑なSQLクエリを作成する場合はコメントが必要になることがよくあります。
    • コメントを付けると、自分がしていることについてメモをとることができます。これにより、他の人があなたが何かをした方法と理由を理解し、必要に応じてそれを維持または変更できるようになります。

    SQLはコメントに適した言語ですか?

    はい!コメントは、SQLやPHPなどの言語と組み合わせて使用​​されることが最も多く、コメント関数* /を使用してテキストファイルまたはスクリプトに挿入できます(例:/*これは私のコメントです*/)。通常、他の場所でも同じように簡単に使用できます。

    SQLでコメントする方法は?

    コメント関数を使用すると、SQLでコメントを追加するためのテキストを記述できます。事前にプログラムされた明確な文字の前後にある限り、最終出力には影響しません。

    SQLにコメントを追加するには、次の記号を使用できます: / * * / または または (ダブルダッシュ)。

    / * * / 他に何も使用せずに、その時点でコメントを開始および終了したい状況(一重引用符など)で機能します。

    一度に1行のコードに使用されます

    一度に1つのコード行にも適用されます。この二重ダッシュの後にスペースを入れることを忘れないでください。

    コードでは、次のようになります。

    -- this is a comment
    # this is also a comment
    /*
       multiline
       comment
    */
    

    1行コメントと複数行コメントの違いは次のとおりです。

    mysql> SELECT 1+1;     # This comment continues to the end of line
    mysql> SELECT 1+1;     -- This comment continues to the end of line
    mysql> SELECT 1 /* this is an in-line comment */ + 1;
    mysql> SELECT 1+
    /*
    this is a
    multiple-line comment
    */
    1;
    

    複数行のコメントの別の例を次に示します。

    SELECT contact_id, last_name, first_name
    /*
     * Author: TechOnTheNet.com
     * Purpose: To show a comment that spans multiple lines in your SQL
     * statement in MySQL.
     */
    FROM contacts;
    

    #記号を使用したコメント

    基本的なハッシュコメント スタイルは次のようにテキストに挿入できます:

    Select * from users ; # this will list users

    ダブルダッシュ(–)を使用したコメント

    これはほぼ同じです(スペースを忘れないでください)。標準SQLでは実際にスペースを使用する必要はありませんが、MySQLはSELECT 10–1などのコマンドの問題を回避するためにスペースを使用します。

    Select * from users ; -- this will list users

    /*および*/記号を使用したコメント

    この複数行のコメントは、前の2つの例とは異なり、行の終わりで停止する必要はありません。

    Select * from users ; /* this will list users */

    実行可能コメント

    原則として、コメントは相手側の誰もが無視しますが(プログラマー専用であるため)、一部のコメントタイプ(実行可能コメント)では、一部のシステムでコードを実行できます。

    この場合、実行可能コメントを使用すると、他のデータベースではなく、MYSQLでのみ実行されるSQLコードを使用できます。

    実行可能コメントは、アスタリスクの付いたスラッシュ内に含める必要があります 、通常のコードと同様:

    / *! MySQL固有のコード*/

    ただし、これらの実行可能コメントには、次のような特定の構文が必要です。

    / *!#####MySQL固有のコード*/

    !#####が必要です 実行可能コメントを通知する部分。これは、解説を実行できるMYSQLの最小バージョンを表します。

    最初のハッシュの代わりに、MYSQLのメインバージョンに置き換えてください。 2番目の代わりに、新しいバージョンとパッチのバージョンが最後の2に置き換えられます。

    次のコメントを実行できるのは、MySQL5.1.10以降のバージョンのみです。

    CREATE TABLE t1 (
    k INT AUTO_INCREMENT,
    KEY (k)
    ) /*!50110 KEY_BLOCK_SIZE=1024; */
    

    結論

    コメントは、詳細を追加することでプログラムを読みやすくします。それらはハッシュにいくぶん似ていると考えることができます。テキストの本質をキャプチャするスニペットを提供することで、コードを理解したり、コードの一部を大幅に識別したりするために必要な時間を短縮します。ゼロ知識証明を使用したことがあるか、Googleを介してFacebookにログインしようとしたことがあれば、私たちの意味がわかります。

    そのため、コードにコメントを付けて、それを正しく行う方法を知ることが不可欠です。有益なメモを使用してコードを正確に保つことで、関係するすべてのスペシャリストの生活が楽になります。


    1. 各行の列値に基づいて行を複製する

    2. PHPを介してMySQLデータベースの出力をXMLに取得

    3. MySQLとMariaDBのレプリケーションフェイルオーバーを制御する方法

    4. SQLiteクエリ結果をテキストエディタで自動的に開く