Azure Cosmos DB Veri Gezgini bağlanamıyor

  • Makale

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 veya Failed 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.