Dev Faq
-1
votes

Quelle est la bonne façon de commenter dans SQL?

La manière dont je commencère semble être en train de jouer avec mon script ou passe simplement au-delà des commentaires, pourquoi le fait-il et quelle est la «voie sûre» de commenter?

Exemple 1: p>

comptez (*) comme "Numberfusers" - Nombre de numéros d'utilisateurs code> p>

Exemple 2: P>

comptez (*) comme "numérosofusers" / * Nombre de numéros d'utilisateurs * / code> p>

Exemple 3: P> 

COUNT(*) AS "NumberOfUsers" 
-- Count Number Of Users

2 commentaires

Les deux sont des moyens valides de commenter dans SQL, lequel vous préférez est une question de goût

Si vous avez des problèmes que les lignes semblent être ignorées, vous devez peut-être montrer un exemple de script. De plus, comment l'exécutez-vous? (Devinement sauvage) Peut-il y avoir un problème de fin de lignes, qui provoque la fin de la fin de A - commentaires?

3 Réponses :

1
votes

Votre exemple est correct et il est une bonne pratique de faire des commentaires dans le script SQL.

  • - est utilisé pour un commentaire de ligne unique.
  • / * * / est utilisé pour plusieurs commentaires de ligne.

    commentaire est généralement donné avant la logique.

    quelque chose comme: xxx

    ou un commentaire unique peut être donné après l'expression comme suit Pour une bonne lisibilité: xxx

    acclamations !!

2 commentaires

Je pensais que, mais mes scripts ne courent pas avec les commentaires, j'utilise SQL Plus à Oracle

@Gentiangashi Un exemple de ce qui ne fonctionne pas serait utile. Le seul cas à laquelle je peux penser que cela pourrait provoquer un script SQL * Plus de ne pas fonctionner serait l'endroit où vous placez un commentaire sur la même ligne qu'un (code> (code>; ou / caractère , en tant que caractères de terminaison SQL, les caractères doivent être sur leur propre ligne.

5
votes

Dois-je commenter mon script SQL du tout?

La réponse générale est "oui". Cependant, ce commentaire est inutile: xxx

Il est préférable d'écrire du code qui est clair. Et vous avez nommé comptez (*) clairement, aucun commentaire n'est nécessaire.

Où voulez-vous utiliser des commentaires? Voici des exemples de commentaires utiles:

  • - une jointure gauche est nécessaire car tous les utilisateurs n'ont pas d'applications
  • - Utilisation intentionnelle de l'Union pour supprimer des doublons
  • - coalesce () est nécessaire car la valeur peut être null! Nous devrons peut-être régler les données.

    Un commentaire indiquant: xxx

    n'est pas utile . Toute personne qui comprend Basic SQL sait ce que cela fait.

    Nous venons d'avoir cette conversation avec mon groupe au travail. Les commentaires doivent ajouter des informations qui ne sont pas évidentes dans le code.

2 commentaires

L'exemple n'est pas pertinent ici, je vais essayer de reformuler, ma principale préoccupation était que les commentaires semblent effectuer le script et le faire sauter des lignes, j'ai essayé de la chercher mais personne d'autre ne semble avoir rencontré ce problème.

@Gentiangashi. . . C'est juste ironique pour moi que nous avons eu une discussion sur un commentaire très similaire. Il suffit de nommer la variable élimine correctement la nécessité d'un commentaire.

1
votes

Commentaires basiques:

  • - Pour les commentaires simples
  • / * (commentaire de démarrage) * / (commentaire final)

    Vous devriez commenter votre SQL, mais essayez de le faire de manière utile.

    • Que fait ma requête?
    • Y a-t-il quelque chose de spécial à propos de ma requête?
    • etc.
0 commentaires

Articles qui pourrait vous intéresser :

Ordre des requêtes de syntaxe SQL par
Problème de jointure sql, impossible de récupérer les enregistrements de la table a qui correspondent à une condition de la table b et les enregistrements restants de la table a
Interroger les données de PostgreSQL à partir de deux tables
Comment identifier les lignes par groupe avant un certain écart de valeur?