COMMENT ON <nesne türü> <ad> IS '<metin>' [FOR LOCALE '<dil>' [LEVEL 1 | 2 | 3]]

Yorum nesnenin açıklaması olur: COLUMN, TABLE, VIEW, DOMAIN, SEQUENCE/GENERATOR, PROCEDURE, FUNCTION, EXTERNAL FUNCTION, PACKAGE, TRIGGER, INDEX, EXCEPTION, ROLE, USER, SCHEMA, COLLATION, DATABASE (yalnızca geçerli veritabanı) için uygulanır ve COMMIT'te kataloğa (ivd$objects.ivd$description) yazılır; ROLLBACK eski değeri geri koyar. CHARACTER SET, FILTER ve PARAMETER adıyla reddedilir (katalogda yoklar / adla adreslenmez), sistem nesneleri değiştirilemez.

6.6.1 Dil sürümleri: FOR LOCALE … LEVEL … (IVD$LOCALIZATION)

FOR LOCALE '<dil>' verilen yorum nesnenin açıklamasına dokunmaz; sys.ivd$localization'a bir dil satırı yazar (ivd$locale BCP 47 dil kodu metni: 'tr', 'en', 'en-US'). LEVEL satırın düzeyidir: 1 caption (öndeğer), 2 hint, 3 doc; 1 ve 2 ivd$description (128 karakter) kolonuna, 3 tam metniyle ivd$description_text'e (ilk 128 karakteri ivd$description'da) yazılır. Aynı dil + aynı düzey satırı değiştirilir; satır COMMIT'te yazılır (ROLLBACK yazmaz), nesne düşünce gider, kimlik koruyan yeniden tanımda (haklar gibi) kalır. LEVEL yalnız FOR LOCALE ile geçerlidir; 1..3 dışı OUT_OF_RANGE. Lehçe çeviriminde (PostgreSQL/Firebird) karşılığı yoktur, yorum satırı olarak geçer.

Okuyucu Metadata paketi: Metadata.Description(<nesne>, <dil> [, <düzey>]) ve kısayolu Metadata.Caption(<nesne>, <dil>) (düzey 1). Bir kolonda arama zincir boyunca yapılır: kolonun kendisi, görünüm kolonuysa görünümün SELECT'inde onu veren kaynak kolon (iç görünümler üzerinden de), sonra kolonun domain'i ve o domain'in domain'i; yerleşik tipte durur. Önce istenen dildeki satır zincirde aranır, ilk bulunan döner. Caption düzeyinde hiçbir halkada dil satırı yoksa aynı zincirdeki ilk düz açıklamaya (ivd$description) düşer, o da yoksa NULL; 2 ve 3'te satır yoksa NULL. İfade kolonunun kaynağı yoktur. Nesne adı noktalı olabilir (TABLO.KOLON). Sınama modülleri: sqltest/ddl/test35-localization.sql, sqltest/tools/metadata_caption_chain_test.py.