Azure Time Series Analizler 2. Nesil Sorgu API'leri

Genel Bakış

Sorgu API'leri üç REST API'si tarafından, her biri olaylar, seriler ve toplamalar için bir API oluşturur.

Sorgu API'leri, isteğe bağlı sayfalama ile HTTP GET istekleri aracılığıyla belirtilen zaman aralığı içinde olay şemasını ve olay sayılarını geri döner. Seri ve toplama serisi bilgileri, isteğe bağlı sayfalama ile GET işlemleri aracılığıyla da ortaya çıkar.

API Açıklama
Olayları Al API'si Arama aralığı ve hazırlıkla eşan ham olayların listesini döndürür.
SeriLeri Al API'si Modelde tanımlanan veya satır içinde Analizler değişkenler aracılığıyla kabloya kaydedilen verileri kullanarak Zaman Serisi'nin yakalanan olaylardan veri toplamaya ve sorgulamaya olanak sağlar.
Toplama Serisi API'si Toplanan veya örnek işlevleri kullanarak Analizler toplanmış verileri toparak yakalanan olaylardan veri toplamaya yönelik Zaman Serisi verilerini sorgulama ve alma işlemi sağlar.

API'ler, HTTP isteği JSON gövdesi aracılığıyla belirtilen çeşitli özelleştirilmiş işlemleri de destekler. Sorgu tanımları yaygın işlemler için kullanılabilir.

Önemli

  • JSON düzlük ve kaçış kurallarındayapılacak değişikliklerin bir parçası olarak diziler Dinamik tür olarak depolanır. Bu tür olarak depolanan yük özelliklerine YALNıZLIK OLARAK Olayları Al API'si aracılığıyla erişilebilir.

Hata yanıtları

Sorgu yürütme başarısız olursa, JSON yanıt yükü aşağıdaki yapıya uygun bir hata yanıtı içerir:

{
    "error" : {
        "code" : "...",
        "message" : "...",
        "innerError" : {  
            "code" : "...",
            "message" : "...",
        }
    }
}

Burada innerError isteğe bağlıdır. Hatalı biçimlendirilmiş istek gibi temel hatalara ek olarak aşağıdaki hatalar döndürülür:

Http durum kodu Hata kodu Örnek hata iletisi Olası innerError kodları
400 InvalidApiVersion '2016' API sürümü desteklenmiyor. Desteklenen sürümler :'2016-12-12', '2018-11-01-preview'. -
400 InvalidUrl '/a/b' istek URL'si ayrıştırıldı. -
400 InvalidInput Verilen 'aggregate' sorgusu geçerli değil. Desteklenen sorgular :'getEvents','getSeries','aggregateSeries'. InvalidQueryType
400 InvalidInput 'projectedVariables.temperature.value' içinde '$event.temperature.Double > 0' zaman serisi ifadesi geçerli bir özellik başvuru ifadesi değildir. InvalidPropertyReferenceExpression
400 InvalidInput 'projectedVariables.temperature.filter' içinde '$event.temperature.Double' zaman serisi ifadesi geçersiz. Yalnızca boole döndüren bir ifade olabilir. InvalidPredicateExpression
400 InvalidInput 'projectedVariables.temperature.aggregation' içinde '$event.temperature.Double' zaman serisi ifadesi geçersiz. Toplama ifadesi içermedi. InvalidAggregateExpression
400 InvalidInput 'projectedVariables.temperature.value' içinde '$event.temperature.Double > 0' zaman serisi ifadesi, 'sayısal' türünde geçerli bir değer ifadesi değildir. InvalidValueExpression
400 InvalidInput 'projectedVariables.temperature.value' içinde değer zaman serisi ifadesi belirtilmez veya 'aggregate' türü değişken için null olmalıdır. ValueExpressionShouldNotBeSpecified
400 InvalidInput 'projectedVariables.temperature.value' içinde değer zaman serisi ifadesi', 'numeric' değişken türü için belirtilmelidir. ValueExpressionShouldBeSpecified
400 InvalidInput 'aggregate' değişken türü, 'projectedVariables.temperature.aggregation' içinde 'min($value)' ifadesi için geçersizdir. InvalidVariableKind
400 InvalidInput 'interval' içinde '00.00:01' zaman aralığı geçerli bir ISO8601 zaman aralığı biçimi değildir. InvalidTimeSpanFormat
400 InvalidInput timeSeriesId '[ " ABC123 " ]' olan örnek bulunamadı. InstanceNotFound
400 InvalidInput 'timeSeriesName' adlı örnek bulunamadı. InstanceNotFound
400 InvalidInput timeSeriesId '[ " ABC321 " ]' olan örnek silinemiyor. Bu zaman serisi kimliğiyle ilişkili zaten alındı olayları vardır. CannotDeleteInstance
400 InvalidInput '5e19f688-83fb-4aee-8321-5c123ed016b7' kimliğine sahip ortam, zaman serisi sorgu API'lerini desteklemez. TimeSeriesQueryNotSupported
400 InvalidInput 'temperature' adına sahip projeli değişken, tür veya satır içi değişken tanımlarında bulunamadı. ProjectedVariableNotFound
400 InvalidInput '7e19g688-83fb-4aee-8321-5c123ed016b7' kimliğine ve 'ABC123' adına sahip tür upsert edilemez. Bu ad zaten '6e19g688-83fb-4aee-8321-5c123ed016b7' kimliğine sahip tür tarafından kullanılıyor. NameAlreadyExists
400 Invalidınput ' 4e19g688-83fb-4aee-8321-7c123ed016b7 ' ve adı ' XYZ123 ' olan hiyerarşi yukarı eklenemiyor. Bu ad, ' 8e39g688-83fb-4aee-8321-5c123ed016b7 ' KIMLIKLI hiyerarşi tarafından zaten kullanılıyor. HierarchyNotDefined
400 Invalidınput Örnek sayısı ' 1.000.000 ' sınırını aştı. Numberofınstancesexceededlimit
400 Invalidınput Türlerin sayısı ' 1000 ' olan sınırı aştı. NumberOfTypesExceededLimit
400 Invalidınput Hiyerarşi sayısı ' 32 ' sınırını aştı. Numberofıbir ıesexceededlimit
400 Invalidınput Varlık boyutu, izin verilen en büyük boyuttan (' 16.384 ') daha fazla. ObjectSizeExceededLimit
400 Invalidınput ' 6 ' uzunluğundaki ' ABC123 ' nesne adı, izin verilen ' 5 ' karakter üst sınırını aşıyor. NameExceededLimit
408 RequestTimeout İstek ' 30 ' saniyeden sonra zaman aşımına uğradı. BatchRequestSizeExceededLimit
503 TooManyRequests ' 95880732-01b9-44EA-8D2D-4d764dfe1904 ' ortamı için eşzamanlı istek sayısı ' 30 ' aşıldı. Envrequestlimitexceıbaşında

Ayrıca bkz.

  • uygulama kaydı ve Azure Active Directory programlama modeli hakkında daha fazla bilgi için bkz. Azure Active Directory for developers.

  • İstek ve kimlik doğrulama parametreleri hakkında bilgi edinmek için kimlik doğrulaması ve yetkilendirmeyiokuyun.

  • HTTP isteklerinin ve yanıtlarının test edilmesine yardımcı olan araçlar şunlardır:

  • Fiddler. Bu ücretsiz Web hata ayıklama proxy 'si REST isteklerinizi ele geçirebilir, böylece HTTP isteği ve yanıt iletilerini tanılayabilirsiniz.

  • JWT.io. Bu aracı kullanarak, taşıyıcı belirteçinizdeki taleplerin hızla dökümünü yapabilir ve sonra içeriklerini doğrulayabilirsiniz.

  • Postman. Bu, REST API 'Leri hata ayıklama için ücretsiz bir HTTP isteği ve yanıt sınama aracıdır.

  • Gen2 belgeleriniinceleyerek Azure Time Series Insights Gen2 hakkında daha fazla bilgi edinin.