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.

Önkoşullar

NoSQL için Mevcut Azure Cosmos DB, MongoDB RU, Apache Cassandra, Apache Gremlin veya Tablo hesabı

Belirtiler

Azure Portal'dan 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ını 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 IÇIN API çözümü

Veritabanı, kapsayıcı, grafik 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 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ılan hesaplar (seçili ağlar) için, geçerli cihazınızdan hesaba erişime izin vermek için bir güvenlik duvarı kuralı oluşturmanız gerekir. Azure portalındaki hizmetin sayfasındaki Ağ özelliği, IP adresinizi otomatik olarak ekleyebilen Geçerli IP'mi ekle (...) köprüsüne sahiptir.

• Hesabın 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çeriyor:

  API	Hata
  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.
  Table	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 IÇIN API çözümü

Sırasıyla kontrol düzlemi ve veri düzlemi çözümlerini gözden geçirin.

Veritabanı, anahtar alanı ve koleksiyon (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ında 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ındaki hizmetin 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.