Files
2nd/10_Wiki/Topics/Domain_Programming/Topic_SQL/SQL_Comments.md
T
Antigravity Agent c24165b8bc refactor(topics): 멀티 에이전트용 지식 재편 — _Common(공통 기본기) + Domain_* 구조
에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게
[공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류.
문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인).

- Topic_Programming → Domain_Programming (내부 구조 보존)
- Topic_Graphic → Domain_Design
- Topic_Business → Domain_Product
- Topic_General → Domain_General
- _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning),
  Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing)
- 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서)
- 빈 폴더 정리 (memory/procedures)
- 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 11:05:56 +09:00

3.8 KiB

id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, review_reason, merge_history, tags, raw_sources, applied_in, github_commit
id title category status verification_status canonical_id aliases duplicate_of source_trust_level confidence_score created_at updated_at review_reason merge_history tags raw_sources applied_in github_commit
sql-comments SQL Comments Database draft conceptual
SQL comment syntax
SQL 주석
B 0.88 2026-07-04 2026-07-04
sql
database
w3schools
comments
https://www.w3schools.com/sql/sql_comments.asp

SQL Comments

🎯 한 줄 통찰 (One-line insight)

SQL supports single-line (--) and multi-line (/* */) comments, ignored by the database engine, useful both for documentation and for temporarily disabling parts of a statement — except in Microsoft Access, which supports neither. [S1]

🧠 핵심 개념 (Core concepts)

  • Purpose — explain SQL code, or temporarily prevent execution of code (for debugging); comments are ignored by the database engine. [S1]
  • Single-line comments — start with -- and continue to the end of the line. [S1]
  • Multi-line comments — start with /* and end with */; any text between is ignored. [S1]
  • MS Access exception — comments are not supported in Microsoft Access databases. [S1]

🧩 추출된 패턴 (Extracted patterns)

  • Comment-out-to-disable — appending -- or wrapping in /* */ is used not just for documentation but as a quick way to disable a clause, a whole statement, or several statements at once without deleting code. [S1]
  • Inline partial comment — a multi-line comment can mask just part of a line/statement (e.g. commenting out one column or one OR-branch) while the rest still executes. [S1]

📖 세부 내용 (Details)

  • Single-line as explanation: -- Selects all German customers followed by the query. [S1]
  • Single-line to comment out the end of a line: SELECT * FROM Customers -- WHERE City='Berlin';. [S1]
  • Single-line to disable an entire statement: -- SELECT * FROM Customers; followed by a different active statement. [S1]
  • Multi-line as explanation: /* Selects all German customers from Berlin */ followed by the query. [S1]
  • Multi-line to disable several statements at once. [S1]
  • Multi-line to mask part of a column list: SELECT CustomerName, /*City,*/ Country FROM Customers;. [S1]
  • Multi-line to mask part of an OR chain inside a WHERE clause. [S1]

⚖️ 모순 및 업데이트 (Contradictions & updates)

  • MS Access는 주석을 지원하지 않음 — 다른 모든 SQL 방언과 다른 예외 사항으로 소스에 명시됨. [S1]

🛠️ 적용 사례 (Applied in summary)

현재 발견된 실제 적용 사례가 없습니다 — 디버깅 중 쿼리 일부를 임시로 비활성화하는 용도로 실무에서 흔히 쓰인다. [S1]

💻 코드 패턴 (Code patterns)

Single-line and multi-line comments (SQL):

-- Selects all German customers
SELECT * FROM Customers
WHERE Country = 'Germany';

/* Selects all German customers
   from Berlin */
SELECT * FROM Customers
WHERE Country = 'Germany' AND City = 'Berlin';

검증 상태 및 신뢰도

  • 상태: draft
  • 검증 단계: conceptual
  • 출처 신뢰도: B (W3Schools — widely used educational reference, not a primary standards body)
  • 신뢰 점수: 0.88
  • 중복 검사 결과: 신규 생성 (New discovery)

🔗 지식 그래프 (Knowledge Graph)

  • 상위/루트: SQL Tutorial
  • 관련 개념: SQL Syntax
  • 참조 맥락: SQL 코드 문서화 및 디버깅 시 쿼리 일부를 비활성화할 때 사용 — MS Access에서는 지원되지 않음에 유의.

📚 출처 (Sources)

📝 변경 이력 (Change history)

  • 2026-07-04: Initial draft synthesized from the W3Schools "SQL Comments" page (Astra wiki-curation, P-Reinforce v3.1 format).