Databricks SQL API başvurusu
Önemli
Bu özellik Genel Önizlemededir.
Databricks SQL REST API sorguları ve panoları, sorgu geçmişini ve uç noktaları yönetmeye SQL destekler.
Bu makalede, REST API’nin nasıl kullanılacağına ilişkin bir genel bakış sunulmaktadır. Her API başvurusunun bağlantısı, makalenin sonunda listelenmiştir.
Kişisel erişim belirteçlerini kullanarak REST API kimlik doğrulaması hakkında bilgi için bkz. Databricks'te Azure Databrickserişim belirteçlerini kullanarak SQL.
Azure Active Directory belirteçlerini kullanarak REST API kimlik doğrulaması hakkında daha fazla bilgi için bkz. Azure Active Directory belirteçlerini kullanarak kimlik doğrulaması. Örnekler için bkz. Bir Kullanıcı için Azure AD erişim belirteci kullanma ve Hizmet sorumlusu için Azure AD erişim belirteci kullanma.
Hız sınırları
Databricks REST API’si, çalışma alanı başına saniyede en fazla 30 isteği destekler. Hız sınırını aşan istekler, 429 yanıt durum kodunu alır.
Ayrıştırma çıkışı
JSON çıkışının parçalarını ayrıştırmak yararlı olabilir. Bu durumlarda, jq yardımcı programını kullanmanızı öneririz. Daha fazla bilgi edinmek için bkz. jq kullanıcı kılavuzu. brew install jq komutunu çalıştırıp Homebrew’u kullanarak macOS’de jq yüklemesi gerçekleştirebilirsiniz.
Bazı alanlar (kullanıcı arabirimi tarafından kullanılmak üzere hata ve açıklayıcı mesajlaşma içerir) yapılandırılmamışdır ve programlı iş akışlarında bu alanların biçimine STRING bağlı olmayabilirsiniz.
Sorgu dizesi kullanarak GET çağırma
Çoğu API çağrısı bir JSON gövdesi belirtmenizi gerektirirken, GET çağrılar için alın nesnesini belirtebilirsiniz. Örneğin, bir uç noktanın ayrıntılarını almak SQL çalıştırın:
curl ... https://<databricks-instance>/api/2.0/sql/endpoints/<endpoint-id>