MongoDB Compass Kullanımı: Kapsamlı Bir Rehber

Giriş

MongoDB Compass, MongoDB veritabanı ile etkileşim kurmak için geliştirilmiş, grafiksel bir kullanıcı arayüzüne (GUI) sahip güçlü bir araçtır. Geliştiricilerin, veritabanı yöneticilerinin ve veri analistlerinin, karmaşık komut satırı arayüzleri veya kod yazma gereksinimi olmadan MongoDB verilerini görsel olarak keşfetmelerini, yönetmelerini ve analiz etmelerini sağlar. Compass, veritabanı şemasını anlamaktan, sorguları görsel olarak oluşturmaya, indeksleri yönetmeye ve hatta performans sorunlarını izlemeye kadar geniş bir yelpazede özellik sunar. Bu kapsamlı rehberde, MongoDB Compass’ı baştan sona nasıl kullanacağınızı, kurulumundan ileri düzey özelliklerine kadar adım adım öğreneceksiniz.

MongoDB’nin esnek şemalı yapısı, verilerin düzenini anlamayı bazen zorlaştırabilir. Compass, bu zorluğu ortadan kaldırarak verilerinizi net bir şekilde görmenizi, koleksiyonlarınızdaki belgeleri kolayca filtrelemenizi, eklemenizi, güncellemenizi ve silmenizi sağlar. Ayrıca, performans analizi araçları sayesinde sorgularınızın nasıl çalıştığını anlayabilir ve veritabanı operasyonlarınızı optimize edebilirsiniz. Agregasyon pipeline’larını görsel olarak oluşturma yeteneği, karmaşık veri analizi görevlerini basitleştirir ve geliştirme sürecini hızlandırır.

MongoDB Compass Kurulumu

MongoDB Compass’ı kullanmaya başlamak için öncelikle bilgisayarınıza kurmanız gerekmektedir. Kurulum süreci oldukça basittir ve çoğu işletim sistemi için benzer adımları içerir.

İndirme Adımları

MongoDB Compass’ı indirmek için MongoDB’nin resmi web sitesini ziyaret etmeniz en güvenli yoldur.

Web tarayıcınızdan https://www.mongodb.com/try/download/compass adresine gidin.
İşletim sisteminize (Windows, macOS, Linux) uygun sürümü seçin. Genellikle web sitesi, kullandığınız işletim sistemini otomatik olarak algılar ve uygun sürümü önerir.
“Download” butonuna tıklayarak kurulum dosyasını indirin.

Kurulum Süreci

İndirme işlemi tamamlandıktan sonra, işletim sisteminize göre kurulum adımlarını izleyin:

Windows İçin:

İndirdiğiniz .exe uzantılı kurulum dosyasına çift tıklayın.
Kurulum sihirbazı başlayacaktır. Genellikle herhangi bir ek yapılandırma gerektirmez; “Next” ve “Install” butonlarına tıklayarak varsayılan seçeneklerle ilerleyebilirsiniz.
Kurulum tamamlandığında “Finish” butonuna tıklayın. Compass otomatik olarak başlayabilir veya Başlat Menüsü’nden bulup açabilirsiniz.

macOS İçin:

İndirdiğiniz .dmg uzantılı dosyayı açın.
Açılan pencerede MongoDB Compass uygulamasını “Applications” klasörüne sürükleyin.
Uygulamalar klasöründen MongoDB Compass’ı başlatın. İlk açılışta güvenlik uyarısı alabilirsiniz; “Open” seçeneğini seçerek devam edin.

Linux İçin (Debian/Ubuntu tabanlı):

İndirdiğiniz .deb dosyasını terminal üzerinden veya grafiksel paket yükleyici ile kurabilirsiniz.
- Terminal üzerinden: sudo dpkg -i mongodb-compass_*.deb komutunu kullanın. Eksik bağımlılıklar varsa sudo apt-get install -f komutunu çalıştırın.
- Grafiksel: Dosya yöneticinizden .deb dosyasına çift tıklayarak paket yükleyiciyi açın ve “Install” butonuna tıklayın.
Kurulum tamamlandıktan sonra uygulama menünüzden MongoDB Compass’ı başlatabilirsiniz.

MongoDB Veritabanına Bağlanma

MongoDB Compass’ı başarıyla kurduktan sonra, bir MongoDB veritabanına bağlanmanız gerekir. Compass, hem yerel hem de uzak veritabanlarına kolayca bağlanma imkanı sunar.

Bağlantı Türleri

Yerel Bağlantı: Bilgisayarınızda çalışan bir MongoDB sunucusuna bağlanmak için kullanılır. Genellikle mongodb://localhost:27017 varsayılan adresiyle hızlıca bağlanabilirsiniz.
Uzak Bağlantı: Bir bulut sağlayıcısında (MongoDB Atlas gibi) veya başka bir sunucuda barındırılan bir MongoDB örneğine bağlanmak için kullanılır. Bu tür bağlantılar genellikle kimlik doğrulama, SSL/TLS ve bazen SSH tünelleme gerektirir.

Standart Bağlantı (URI String)

En yaygın ve önerilen bağlantı yöntemi, bir bağlantı dizesi (Connection String URI) kullanmaktır. Bu dize, sunucu adresi, port, kimlik doğrulama bilgileri ve diğer seçenekleri tek bir formatta içerir.

Compass’ı başlattığınızda karşınıza çıkan ilk ekran genellikle “Connect” ekranıdır.
“New Connection” butonuna tıklayın.
“URI” sekmesini seçin.
Bağlantı dizenizi (örn: mongodb://username:password@host:port/databaseName?authSource=admin) “URI” alanına yapıştırın.
“Connect” butonuna tıklayın.

Manuel Bağlantı Ayarları

Eğer bir bağlantı dizeniz yoksa veya ayarları manuel olarak yapılandırmak istiyorsanız:

“New Connection” butonuna tıklayın.
“Fill in connection fields individually” seçeneğini seçin.
Hostname: MongoDB sunucusunun IP adresi veya ana bilgisayar adı (örn: localhost, 192.168.1.100, mycluster.mongodb.net).
Port: MongoDB’nin dinlediği port numarası (varsayılan: 27017).
Authentication (Kimlik Doğrulama): Eğer veritabanınız kullanıcı adı ve şifre gerektiriyorsa bu bölümü yapılandırmanız gerekir.
- Authentication Method: Genellikle “Username / Password” seçilir.
- Username: MongoDB kullanıcınızın adı.
- Password: MongoDB kullanıcınızın şifresi.
- Authentication Database: Kullanıcının tanımlandığı veritabanı (genellikle admin veya authSource parametresi).
SSL/TLS: Güvenli bağlantılar için SSL/TLS’yi etkinleştirin.
- “Use SSL/TLS” seçeneğini işaretleyin.
- Gerektiğinde “Server CA Certificate”, “Client Certificate” ve “Client Private Key” dosyalarını sağlayın.
SSH Tünelleme (SSH Tunnel): Uzak sunuculara SSH üzerinden bağlanmanız gerekiyorsa bu bölümü kullanın.
- “Use SSH Tunnel” seçeneğini işaretleyin.
- SSH Host: SSH sunucusunun adresi.
- SSH Port: SSH portu (varsayılan: 22).
- SSH Username: SSH kullanıcınızın adı.
- Authentication Method: “Password” veya “Identity File (PEM)” seçin ve ilgili bilgileri girin.
Tüm ayarları yaptıktan sonra “Connect” butonuna tıklayın.

Bağlantı Kaydetme ve Yönetme

Bir kez başarılı bir şekilde bağlandığınızda, Compass bu bağlantıyı kaydedebilir. Gelecekte aynı veritabanına daha hızlı erişmek için bu özelliği kullanın.

Bağlantı ekranında “Save & Connect” veya “Save” butonuna tıklayarak bağlantı ayarlarını kaydedin.
Kaydedilen bağlantılar, Compass’ın ana ekranında “My Connections” altında listelenir.
Kaydedilmiş bir bağlantıyı düzenlemek veya silmek için ilgili bağlantının yanındaki üç nokta menüsünü kullanabilirsiniz.

Veritabanı ve Koleksiyonları Yönetme

Bağlantı kurulduktan sonra, MongoDB Compass’ın ana arayüzüne yönlendirilirsiniz. Burada bağlı olduğunuz MongoDB örneğindeki tüm veritabanlarını ve bunların içindeki koleksiyonları görebilirsiniz.

Veritabanlarını Görüntüleme

Sol taraftaki gezinme panelinde, bağlı olduğunuz MongoDB örneğindeki tüm veritabanları listelenir. Varsayılan olarak admin, config ve local gibi sistem veritabanları da burada görünür.

Yeni Veritabanı Oluşturma

Sol panelde “Databases” başlığının yanındaki “+” simgesine tıklayın veya ana ekranda “Create Database” butonunu kullanın.
Açılan pencerede:
- Database Name: Oluşturmak istediğiniz veritabanının adını girin.
- Collection Name: Bu veritabanı içinde oluşturulacak ilk koleksiyonun adını girin. (Her veritabanının en az bir koleksiyonu olmalıdır.)
“Create Database” butonuna tıklayın.

Veritabanı Silme

Bir veritabanını silmek, içindeki tüm koleksiyonları ve belgeleri kalıcı olarak silecektir, bu yüzden dikkatli olun.

Sol panelde silmek istediğiniz veritabanının üzerine gelin.
Veritabanı adının yanındaki üç nokta menüsüne tıklayın ve “Drop Database” seçeneğini seçin.
Onay penceresinde veritabanının adını yazarak işlemi onaylayın ve “Drop” butonuna tıklayın.

Koleksiyonları Görüntüleme

Sol panelde bir veritabanının adına tıkladığınızda, o veritabanındaki tüm koleksiyonlar listelenir. Her koleksiyonun yanında belge sayısı gösterilir.

Yeni Koleksiyon Oluşturma

Sol panelde koleksiyon oluşturmak istediğiniz veritabanının adına tıklayın.
Veritabanı adının yanındaki “+” simgesine tıklayın veya sağ üstteki “Create Collection” butonunu kullanın.
Açılan pencerede:
- Collection Name: Oluşturmak istediğiniz koleksiyonun adını girin.
- Capped Collection: İsteğe bağlı olarak “Capped Collection” seçeneğini işaretleyerek sabit boyutlu bir koleksiyon oluşturabilirsiniz. Bu, belirli bir boyuta ulaştığında en eski belgeleri otomatik olarak silen bir koleksiyondur.
“Create Collection” butonuna tıklayın.

Koleksiyon Silme/Yeniden Adlandırma

Sol panelde silmek veya yeniden adlandırmak istediğiniz koleksiyonun üzerine gelin.
Koleksiyon adının yanındaki üç nokta menüsüne tıklayın.
“Drop Collection”: Koleksiyonu ve içindeki tüm belgeleri kalıcı olarak siler. Onay için koleksiyon adını yazmanız istenecektir.
“Rename Collection”: Koleksiyonu yeniden adlandırmanızı sağlar. Yeni adı girip onaylayın.

Belgelerle Çalışma (CRUD Operasyonları)

MongoDB Compass’ın en temel ve sık kullanılan özelliklerinden biri, koleksiyonlardaki belgeleri (dokümanları) görüntülemek, filtrelemek, eklemek, güncellemek ve silmektir (CRUD – Create, Read, Update, Delete).

Belgeleri Görüntüleme ve Filtreleme (Query Bar)

Bir koleksiyonun adına tıkladığınızda, o koleksiyondaki belgeler ana panelde görünür. Üstteki “Filter” çubuğu (Query Bar) sayesinde belgeleri filtreleyebilirsiniz.

JSON Görünümü: Belgeleri JSON formatında gösterir, hiyerarşik yapıyı anlamak için idealdir.
Tablo Görünümü: Belgeleri bir tablo gibi gösterir, alanları sütunlar halinde düzenler.
Liste Görünümü: Her belgeyi tek bir satırda özetler.

Filtreleme (Query)

“Filter” kutusuna bir MongoDB sorgu nesnesi yazarak belgeleri filtreleyebilirsiniz. Örneğin:

{ "name": "Alice" } – Adı Alice olan belgeleri getirir.
{ "age": { "$gt": 30 } } – Yaşı 30’dan büyük olan belgeleri getirir.
{ "status": { "$in": ["pending", "active"] } } – Durumu “pending” veya “active” olan belgeleri getirir.

Sorguyu yazdıktan sonra “Find” butonuna tıklayın.

Projeksiyon (Projection)

“Projection” kutusuna bir projeksiyon nesnesi yazarak hangi alanların gösterileceğini belirleyebilirsiniz.

{ "name": 1, "email": 1 } – Yalnızca name ve email alanlarını gösterir (ve varsayılan olarak _id).
{ "password": 0 } – password alanı hariç tüm alanları gösterir.

Sıralama (Sort)

“Sort” kutusuna bir sıralama nesnesi yazarak belgeleri belirli alanlara göre sıralayabilirsiniz.

{ "name": 1 } – name alanına göre artan sırada sıralar.
{ "age": -1 } – age alanına göre azalan sırada sıralar.

Limit/Skip

“Limit” ve “Skip” alanlarını kullanarak getirilecek belge sayısını sınırlayabilir ve belirli sayıda belgeyi atlayabilirsiniz. Bu, sayfalama (pagination) için kullanışlıdır.

Belge Ekleme (Insert Document)

Koleksiyon görünümündeyken “Add Data” butonuna tıklayın ve ardından “Insert Document” seçeneğini seçin.
Açılan JSON düzenleyicide yeni belgenizi JSON formatında yazın. Örneğin:
```
{
  "name": "Mehmet Yılmaz",
  "age": 30,
  "city": "İstanbul"
}
```
“Insert” butonuna tıklayın.

Belge Güncelleme (Update Document)

Güncellemek istediğiniz belgeyi bulun ve üzerine tıklayın. Belge ayrı bir pencerede düzenlenebilir JSON formatında açılacaktır.
İstediğiniz alanları değiştirin veya yeni alanlar ekleyin.
Değişiklikleri kaydetmek için “Update” butonuna tıklayın.
Birden fazla belgeyi güncellemek için “Documents” sekmesinde, “Filter” çubuğunu kullanarak güncellenecek belgeleri seçin. Ardından “Modify Documents” seçeneğini kullanabilirsiniz.

Belge Silme (Delete Document)

Silmek istediğiniz belgeyi bulun.
Belgenin yanındaki üç nokta menüsüne tıklayın ve “Delete Document” seçeneğini seçin.
Onay penceresinde “Delete” butonuna tıklayarak işlemi onaylayın.
Birden fazla belgeyi silmek için “Documents” sekmesinde, “Filter” çubuğunu kullanarak silinecek belgeleri seçin. Ardından “Delete Documents” seçeneğini kullanabilirsiniz.

İndeks Yönetimi

İndeksler, MongoDB’de sorgu performansını önemli ölçüde artıran kritik yapılardır. MongoDB Compass, indeksleri görsel olarak oluşturmanıza, yönetmenize ve analiz etmenize olanak tanır.

İndeksleri Görüntüleme

Bir koleksiyonu seçtiğinizde, ana panelde “Indexes” sekmesine tıklayarak o koleksiyondaki tüm mevcut indeksleri görebilirsiniz. Burada indeksin adı, alanı (veya alanları), tipi, benzersiz olup olmadığı gibi bilgiler yer alır.

Yeni İndeks Oluşturma

“Indexes” sekmesindeyken “Create Index” butonuna tıklayın.
Açılan pencerede:
- Index Fields: İndekslemek istediğiniz alanları belirtin. Alan adını girin ve sıralama düzenini (artan için 1, azalan için -1) seçin. Birden fazla alan eklemek için “+” butonunu kullanın (bileşik indeksler için).
- Index Name: İndekse bir isim verin (isteğe bağlı, Compass otomatik oluşturabilir).
- Options:
  - Unique: Bu indeksin benzersiz olmasını istiyorsanız işaretleyin. Bu, indeksli alanda yinelenen değerlere izin vermez.
  - Partial Filter Expression: İndeksi yalnızca belirli koşulları sağlayan belgelere uygulamak için bir filtre ifadesi girin.
  - TTL (Time To Live): Belgelerin belirli bir süre sonra otomatik olarak silinmesini sağlayan indeksler için bu seçeneği kullanın ve saniye cinsinden bir değer girin.
  - Collation: Dil tabanlı sıralama kurallarını belirtmek için kullanılır.
  - Sparse: Yalnızca indeksli alanı içeren belgeleri indekslemek için kullanılır.
“Create Index” butonuna tıklayın.

İndeks Silme

“Indexes” sekmesinde silmek istediğiniz indeksin üzerine gelin.
İndeksin yanındaki üç nokta menüsüne tıklayın ve “Drop Index” seçeneğini seçin.
Onay penceresinde “Drop” butonuna tıklayarak işlemi onaylayın.

İndeks Performans Analizi (Explain Plan)

Sorgularınızın indeksleri nasıl kullandığını ve performansını anlamak için “Explain Plan” özelliğini kullanabilirsiniz.

“Documents” sekmesinde bir sorgu (filter) yazın.
“Explain” butonuna tıklayın.
Compass, sorgunun nasıl yürütüldüğünü, hangi indekslerin kullanıldığını, taranan belge ve indeks anahtar sayısını gösteren ayrıntılı bir rapor sunar. Bu raporu kullanarak sorgularınızı ve indekslerinizi optimize edebilirsiniz.

Agregasyon İşlemleri

Agregasyon pipeline’ları, MongoDB’de karmaşık veri işleme ve analiz görevlerini gerçekleştirmek için güçlü bir yöntemdir. MongoDB Compass, bu pipeline’ları görsel olarak oluşturmanıza ve sonuçları adım adım görmenize olanak tanır.

Agregasyon Pipeline Oluşturma

Bir koleksiyonu seçtikten sonra “Aggregations” sekmesine tıklayın.
Karşınıza boş bir agregasyon pipeline’ı çıkacaktır.

Aşamaları Ekleme

Pipeline’ınıza aşamalar eklemek için “Add Stage” butonuna tıklayın ve açılan menüden istediğiniz aşamayı seçin. Her aşama, önceki aşamanın çıktısını alır ve üzerinde bir işlem yapar.

Yaygın Agregasyon Aşamaları:

$match (Eşleştirme): Belirli kriterlere uyan belgeleri filtreler. SQL’deki WHERE ifadesine benzer.
```
{ $match: { "status": "active", "age": { "$gt": 25 } } }
```
$project (Projeksiyon): Belgelerdeki alanları yeniden şekillendirir, yeni alanlar ekler veya mevcut alanları gizler. SQL’deki SELECT ifadesine benzer.
```
{ $project: { "_id": 0, "fullName": { "$concat": ["$firstName", " ", "$lastName"] }, "email": 1 } }
```
$group (Gruplama): Belgeleri belirli bir anahtara göre gruplar ve her grup için toplama işlemleri yapar (sayım, toplam, ortalama vb.). SQL’deki GROUP BY ifadesine benzer.
```
{ $group: { "_id": "$city", "totalUsers": { "$sum": 1 }, "averageAge": { "$avg": "$age" } } }
```
$sort (Sıralama): Belgeleri belirli bir alana göre sıralar.
```
{ $sort: { "totalUsers": -1 } }
```
$limit (Sınır): Pipeline’dan geçen belge sayısını sınırlar.
$skip (Atlama): Belirli sayıda belgeyi atlar.
$unwind (Çözme): Bir dizi alanını alır ve her dizi öğesi için ayrı bir belge oluşturur.
$lookup (Birleştirme): Başka bir koleksiyondaki belgelerle birleştirme (join) işlemi yapar (ilişkisel veritabanlarındaki JOIN’e benzer).

Her aşamayı ekledikten sonra, Compass otomatik olarak sonuçları güncelleyerek her adımda verinin nasıl dönüştüğünü görsel olarak gösterir. Bu, karmaşık pipeline’ları hata ayıklamak ve anlamak için son derece faydalıdır.

Sonuçları Görselleştirme

Agregasyon sonuçlarını, “Results” sekmesinde JSON formatında veya “Chart” sekmesinde çeşitli grafik türleriyle (çubuk grafik, pasta grafik, çizgi grafik vb.) görselleştirebilirsiniz. Bu, verilerinizdeki eğilimleri ve desenleri hızlıca keşfetmenizi sağlar.

Agregasyon Pipeline’ını Dışa Aktarma

Oluşturduğunuz agregasyon pipeline’ını JavaScript, Java, Python, C#, Node.js veya Mongo Shell formatında dışa aktarabilirsiniz. Bu, uygulamanızda kullanmak üzere kod oluşturmayı kolaylaştırır. “Export to Language” butonuna tıklayarak istediğiniz formatı seçin.

Şema Analizi

MongoDB’nin şemasız (schemaless) yapısı esneklik sağlarken, verilerinizin gerçek şemasını anlamak bazen zor olabilir. MongoDB Compass’ın “Schema” sekmesi, koleksiyonlarınızdaki belgelerin yapısını ve veri tiplerinin dağılımını analiz ederek bu sorunu çözer.

Koleksiyon Şemasını Görüntüleme

Bir koleksiyonu seçtikten sonra “Schema” sekmesine tıklayın.
Compass, koleksiyonunuzdaki belgelerin örneklerini alarak alanların listesini, her alanın veri tipini, yüzdelik dağılımını ve örnek değerlerini gösterir.

Veri Tipleri ve Dağılımları

Şema analizi, her alanın hangi veri tiplerini içerdiğini (örneğin, string, number, boolean, array, object) ve bu tiplerin koleksiyon içindeki yüzdelik dağılımını gösterir. Bu, veri tutarlılık sorunlarını veya beklenmedik veri tiplerini hızlıca tespit etmenize yardımcı olur. Örneğin, bir age alanının hem number hem de string olarak göründüğünü fark ederseniz, veri girişinde bir tutarsızlık olduğunu anlayabilirsiniz.

Şema Tutarsızlıklarını Belirleme

Compass, bir alanın farklı belgelerde birden fazla veri tipine sahip olması gibi şema tutarsızlıklarını vurgular. Bu bilgiler, veri modelinizi iyileştirmek, veri temizliği yapmak veya uygulama kodunuzu daha sağlam hale getirmek için kullanılabilir. Şema analizi, özellikle büyük ve karmaşık veri kümeleriyle çalışırken veya yeni bir projeye başlarken çok değerli bir araçtır.

Performans İzleme (Performance Tab)

MongoDB Compass, veritabanınızın gerçek zamanlı performansını izlemenizi sağlayan bir “Performance” sekmesi sunar. Bu özellik, yavaş çalışan sorguları tespit etmek ve genel veritabanı sağlığını anlamak için önemlidir.

Gerçek Zamanlı Veritabanı Performans Metrikleri

“Performance” sekmesine tıkladığınızda, Compass aşağıdaki gibi önemli metrikleri gösteren bir pano sunar:

Query Times: Ortalama sorgu süreleri.
Read/Write Operations: Okuma ve yazma işlemlerinin sayısı.
Active Connections: Veritabanına bağlı aktif istemci sayısı.
Network Traffic: Gelen ve giden ağ trafiği.
Memory Usage: Veritabanının kullandığı bellek miktarı.

Bu metrikler, belirli bir zaman aralığında (son 1 saat, son 24 saat vb.) görsel olarak grafikler halinde sunulur. Bu sayede, performans düşüşlerini veya ani yük artışlarını kolayca fark edebilirsiniz.

Sorgu Süreleri, Okuma/Yazma İşlemleri

Compass, en yavaş sorguları ve en çok kaynak tüketen işlemleri belirlemenize yardımcı olur. Bu bilgiler, indeks optimizasyonu veya sorgu yeniden yazma gibi performans iyileştirme stratejilerini uygulamanıza rehberlik eder. Örneğin, belirli bir sorgunun sürekli olarak yüksek okuma işlemleri yaptığını görürseniz, o sorgu için yeni bir indeks oluşturmayı düşünebilirsiniz.

Diğer Özellikler

MongoDB Compass, yukarıda bahsedilen temel özelliklerin yanı sıra, geliştiricilerin ve yöneticilerin işini kolaylaştıran birçok başka faydalı araç ve özellik sunar.

Kullanıcı ve Rol Yönetimi (Security)

“Security” sekmesi, veritabanı kullanıcılarını ve rollerini yönetmenizi sağlar.

Kullanıcı Oluşturma: Yeni kullanıcılar oluşturabilir, onlara şifre atayabilir ve hangi veritabanlarına erişebileceklerini belirleyebilirsiniz.
Rol Atama: Kullanıcılara mevcut rolleri atayabilir veya özel roller oluşturarak belirli yetkileri (okuma, yazma, indeks oluşturma vb.) tanımlayabilirsiniz.
Rol Düzenleme/Silme: Mevcut rolleri düzenleyebilir veya silebilirsiniz.

Bu özellik, veritabanı güvenliğini sağlamak ve farklı kullanıcılar için erişim kontrolünü yönetmek için kritik öneme sahiptir.

Veri İçe/Dışa Aktarma (Import/Export)

Compass, verileri koleksiyonlara aktarmanıza ve koleksiyonlardan dışa aktarmanıza olanak tanır.

Veri İçe Aktarma (Import Data):
- Bir koleksiyonu seçtikten sonra “Add Data” -> “Import File” seçeneğini kullanın.
- JSON veya CSV formatındaki dosyaları seçerek koleksiyonunuza veri aktarabilirsiniz.
- Compass, CSV dosyaları için alan eşleştirmeleri yapmanıza ve veri tiplerini belirlemenize olanak tanır.
Veri Dışa Aktarma (Export Data):
- Bir koleksiyonu seçtikten sonra “Collection” menüsünden “Export Collection” seçeneğini kullanın.
- Belgeleri JSON veya CSV formatında dışa aktarabilirsiniz. Dışa aktarmadan önce filtreleme, projeksiyon ve sıralama uygulayabilirsiniz.

GridFS (Büyük Dosya Yönetimi)

GridFS, MongoDB’de büyük dosyaları (örneğin, resimler, videolar, belgeler) depolamak için kullanılan bir spesifikasyondur. MongoDB Compass, GridFS koleksiyonlarını görüntülemenize ve içindeki dosyaları yönetmenize olanak tanır.

GridFS koleksiyonları genellikle fs.files ve fs.chunks olarak adlandırılır. Compass bunları otomatik olarak tanır.
Bu koleksiyonlara giderek GridFS ile depolanan dosyaları ve onların parçalarını görebilirsiniz.

Validasyon Kuralları (Validation)

MongoDB 3.2 ve sonraki sürümleri, koleksiyonlara veri doğrulama kuralları eklemenize olanak tanır. Compass, bu kuralları görüntülemenize ve düzenlemenize yardımcı olur.

Bir koleksiyonu seçtikten sonra “Validation” sekmesine gidin.
Burada koleksiyon için tanımlanmış doğrulama kurallarını görebilir ve yeni kurallar ekleyebilir veya mevcut olanları düzenleyebilirsiniz. Bu kurallar, koleksiyona eklenen veya güncellenen belgelerin belirli bir şemaya uymasını sağlar.

Sıkça Sorulan Sorular ve İpuçları

MongoDB Compass kullanırken karşılaşabileceğiniz bazı yaygın sorunlar ve bunlara yönelik çözümler ile verimliliği artıracak ipuçları.

Bağlantı Sorunları

“Connection refused” hatası:
- MongoDB sunucunuzun çalışır durumda olduğundan emin olun.
- Bağlantı ayarlarınızdaki ana bilgisayar adı (hostname) ve port numarasının doğru olduğundan emin olun.
- Firewall (güvenlik duvarı) ayarlarınızın MongoDB portuna (varsayılan 27017) izin verdiğinden emin olun.
- Uzak bağlantı yapıyorsanız, MongoDB sunucunuzun dışarıdan gelen bağlantılara izin verecek şekilde yapılandırıldığından emin olun (örneğin, bindIp ayarı 0.0.0.0 veya belirli IP adresleri olmalı).
Kimlik doğrulama hatası:
- Kullanıcı adınızın ve şifrenizin doğru olduğundan emin olun.
- authSource veritabanının doğru ayarlandığından emin olun (genellikle admin).
- Kullanıcının bağlanmaya çalıştığı veritabanına erişim yetkisi olduğundan emin olun.
SSL/TLS bağlantı sorunları:
- Sertifika dosyalarının (CA, istemci sertifikası, özel anahtar) doğru yolda olduğundan ve geçerli olduğundan emin olun.
- Sunucunun ve istemcinin aynı SSL/TLS protokollerini desteklediğinden emin olun.

Performans İpuçları

İndeksleri Kullanın: Sıkça sorguladığınız alanlara indeksler ekleyin. Explain Plan‘ı kullanarak sorgularınızın indeksleri etkili bir şekilde kullanıp kullanmadığını kontrol edin.
Projeksiyon Kullanın: Yalnızca ihtiyacınız olan alanları getirin ($project veya projection seçeneği). Bu, ağ trafiğini ve bellek kullanımını azaltır.
Limit Kullanın: Büyük koleksiyonlarda gezinirken limit ve skip kullanarak yalnızca ihtiyacınız olan kadar belge getirin.
Agregasyon Pipeline’ını Optimize Edin: $match aşamasını pipeline’ın başına yerleştirerek işlenecek belge sayısını mümkün olduğunca erken azaltın.

Klavye Kısayolları

MongoDB Compass, iş akışınızı hızlandırmak için çeşitli klavye kısayolları sunar. En sık kullanılanlardan bazıları:

Ctrl/Cmd + F: Sorgu çubuğunu açar.
Ctrl/Cmd + S: Bağlantıyı kaydeder.
Ctrl/Cmd + N: Yeni bağlantı oluşturur.
Ctrl/Cmd + Shift + R: Mevcut görünümü yeniler.

Sonuç

MongoDB Compass, MongoDB veritabanı ile çalışmak için vazgeçilmez bir araçtır. Kurulumu kolay, kullanımı sezgisel ve sunduğu geniş özellik yelpazesi sayesinde geliştiricilerin, veritabanı yöneticilerinin ve veri analistlerinin veritabanı etkileşimlerini önemli ölçüde basitleştirir. Bağlantı yönetiminden belge CRUD operasyonlarına, indeks optimizasyonundan karmaşık agregasyon pipeline’larına ve şema analizine kadar her aşamada görsel ve interaktif bir deneyim sunar.

Bu rehber, MongoDB Compass’ın temel ve ileri düzey özelliklerini kapsayarak, bu güçlü aracı etkin bir şekilde kullanmanız için size sağlam bir temel sağlamıştır. Compass’ı kullanarak verilerinizle daha verimli bir şekilde etkileşime geçebilir, sorgularınızı optimize edebilir ve MongoDB projelerinizde daha hızlı ilerleyebilirsiniz. Düzenli olarak Compass’ın yeni sürümlerini kontrol etmek ve yeni özelliklerini keşfetmek, veritabanı yönetim deneyiminizi daha da zenginleştirecektir.

MongoDB Compass Kullanımı: Kapsamlı Bir Rehber