Azure Cosmos DB Veri Gezgini bağlanamıyor
Bazen Azure Cosmos DB Veri Gezgini hesabınıza bağlanamaz veya kaynaklara veya öğelere karşı işlem gerçekleştiremez. Bu makalede, bu sorunun olası nedenleri ve çözümleri inceler.
Önemli
PostgreSQL API'sinde veya sanal çekirdek API'sinde Azure Cosmos DB Veri Gezgini kullanılamaz.
Önkoşullar
NoSQL, MongoDB RU, Apache Cassandra, Apache Gremlin veya Tablo hesabı için mevcut bir Azure Cosmos DB
Belirtiler
Azure Portaldan erişime izin ver seçeneğini etkinleştirdikten sonra bile Veri Gezgini bağlanamazsınız.
Neden
Doğru rol tabanlı erişim denetimini ve portal izinlerini yapılandırdıktan sonra bile, seçtiğiniz API'ye göre yapılandırılması gereken ek ağ erişim gereksinimleri vardır.
NoSQL API'si, Apache Gremlin API'si ve Tablo için API gibi bazı hizmetler, işlemleri gerçekleştirmek ve tek bir çözüm kümesi gerektirmek için istemci tarafı JavaScript SDK'sı kullanır.
MongoDB RU API'si ve Apache Cassandra IÇIN API gibi diğer hizmetler protokole özgü ara yazılımı kullanır ve alternatif bir çözüm gerektirir.
NoSQL, Apache Gremlin veya Tablo API'sine yönelik çözüm
Veritabanı, kapsayıcı, graf ve tablo (denetim düzlemi) işlemleri, Azure Cosmos DB kaynak sağlayıcısı kullanılarak Azure Resource Manager denetim düzlemine yapılan çağrılar aracılığıyla yürütülür. Ağ yapılandırmanız bu işlemleri etkilemez.
Öğe (veri düzlemi) işlemleri, tarayıcınızın bağlamında JavaScript SDK'sı kullanılarak yürütülür. Kullanmakta olduğunuz cihazın hesaba doğrudan ağ erişimi olmalıdır.
Genel erişimle yapılandırılmış hesaplarda (tüm ağlar) veri düzlemi işlemlerde ağ ile ilgili bağlantı sorunları olmamalıdır.
Genel erişimle yapılandırılmış hesaplarda (seçili ağlar) geçerli cihazınızdan hesaba erişime izin vermek için bir güvenlik duvarı kuralı oluşturmanız gerekir. hizmetin Azure portal sayfasındaki Ağ özelliği, IP adresinizi otomatik olarak ekleyebilen Geçerli IP'mi ekle (...) köprüsüne sahiptir.
Hesapta güvenlik duvarı kuralı yoksa, Veri Gezgini Veri Gezgini bildirimlerinde gözlemlenebilir bir hata oluşturur. Bu hata iletisi aşağıdaki örneklere benzer bir metin içerir:
API Error Nosql Request originated from IP XXX.XXX.XXX.XXX through public internet. This is blocked by your Cosmos DB account firewall settings.
Apache Gremlin Failure in submitting query: g.V(): Request originated from IP XXX.XXX.XXX.XXX through public internet. This is blocked by your Cosmos DB account firewall settings.
Tablo Error while refreshing databases: Request originated from IP XXX.XXX.XXX.XXX through public internet. This is blocked by your Cosmos DB account firewall settings.
Genel erişim devre dışı bırakılmış olarak yapılandırılan hesaplar için cihazınızın, veri düzlemi işlemlerinin çalışması için hesaba bağlantısı olan bir sanal ağa bağlı olması gerekir.
MongoDB RU veya Apache Cassandra API'sine yönelik çözüm
Sırasıyla kontrol düzlemi ve veri düzlemi çözümlerini gözden geçirin.
Veritabanı, anahtar alanı ve toplama (denetim düzlemi) işlemleri, Azure Cosmos DB kaynak sağlayıcısı kullanılarak Azure Resource Manager denetim düzlemine yapılan çağrılar aracılığıyla yürütülür. Ağ yapılandırmanız bu işlemleri etkilemez.
Öğe (veri düzlemi) işlemleri API'nin ara yazılımındaki bir ara sunucu hizmeti kullanılarak yürütülür. Bu hizmet, öğe işlemlerinde ve sorgularında hizmet yerel (MongoDB, Cassandra) protokolünün kullanımını kolaylaştırır. Ara sunucu hizmeti, hesaba doğrudan ağ erişimi gerektirir.
Genel erişimle yapılandırılmış hesaplarda (tüm ağlar) veri düzlemi işlemlerde ağ ile ilgili bağlantı sorunları olmamalıdır.
Genel erişimle yapılandırılan hesaplar için (seçili ağlar) Azure portal hizmet sayfasının Ağ özelliğinde Azure Portaldan Erişime İzin Ver'i seçmeniz gerekir. Bu seçenek, ara yazılım hizmetini içeren bir IP adresi aralığı ekler. Geçerli cihazınızın IP adresini eklemeniz gerekmez .
Hesabın güvenlik duvarı kuralı yoksa, Veri Gezgini tarayıcı geliştirici araçlarında gözlemlenebilir bir hata oluşturur. Bu hata iletisi, ara yazılım hizmeti tarafından oluşturulan genel
Error querying documents
bir ileti veyaFailed to establish connection with cassandra node
ileti içeriyor. Genişletilmiş hata iletisi, aşağıdaki örneğe benzer şekilde İşlem ağ geçidi günlüklerine eklenir:Request originated from IP XXX.XXX.XXX.XXX through public internet. This is blocked by your Cosmos DB account firewall settings.
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin