REST Resource: customers.analysisQueries

Kaynak: AnalysisQuery

Ads Data Hub'da yürütülebilecek bir analiz sorgusu tanımlar.

JSON gösterimi
{
  "name": string,
  "title": string,
  "queryText": string,
  "parameterTypes": {
    string: {
      object (ParameterType)
    },
    ...
  },
  "mergeSpec": {
    object (MergeSpec)
  },
  "queryState": enum (QueryState),
  "updateTime": string,
  "updateEmail": string,
  "createTime": string,
  "createEmail": string,
  "queryShare": [
    {
      object (QueryShare)
    }
  ],

  // Union field filtered_row can be only one of the following:
  "filteredRowSummary": {
    object (FilteredRowSummary)
  },
  "generateFilteredRowSummaryAutomatically": boolean
  // End of list of possible types for union field filtered_row.
}
Alanlar
name

string

Bir sorguyu benzersiz şekilde tanımlayan ad. Bu alan, müşteriler/[müşterikimliği]/analysisSorgular/[kaynak_kimliği] biçiminde olmalıdır; ör. 'customers/123/analysisSorgular/abcd1234' Kaynak kimliği, sunucu tarafından oluşturulur.

title

string

Tek bir Ads Data Hub müşterisi ve sorgu türü içinde benzersiz olan sorgu başlığı.

queryText

string

Standart SQL'de yazılmış sorgu metni. https://cloud.google.com/bigquery/docs/reference/standard-sql/ sayfasına bakın.

parameterTypes

map (key: string, value: object (ParameterType))

Sorgunun beklenen tüm ek parametreler. Her bağımsız değişken adını bağımsız değişken türüyle eşleştirir.

"key": value çift listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

mergeSpec
(deprecated)

object (MergeSpec)

Satır birleştirme talimatları. Bu durumda, gizlilik nedeniyle çıkarılmış olan satırlar birleştirilmiş tek bir satırda birleştirilir. Birleştirilen satır gizlilik koşullarını karşılıyorsa birleştirilmiş satır son çıkış olur.

queryState

enum (QueryState)

Sorgu durumu.

updateTime

string (Timestamp format)

Sorgunun son güncellendiği zaman.

RFC3339 UTC "Zulu&quot" biçiminde nanosaniye çözünürlüğe ve dokuz adede kadar kesir basamağına sahip zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

updateEmail

string

Sorguyu en son güncelleyen kullanıcının e-posta adresi.

createTime

string (Timestamp format)

Sorgunun oluşturulduğu saat.

RFC3339 UTC "Zulu&quot" biçiminde nanosaniye çözünürlüğe ve dokuz adede kadar kesir basamağına sahip zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

createEmail

string

Sorguyu oluşturan kullanıcının e-posta adresi.

queryShare[]

object (QueryShare)

Bir sorgunun, kendisine ait Ads Data Hub müşterisi dışında da ne şekilde paylaşılabileceğini belirtir.

Birlik alanı filtered_row. Satır birleştirme talimatları. filtered_row aşağıdakilerden yalnızca biri olabilir:
filteredRowSummary

object (FilteredRowSummary)

Gizlilik nedeniyle bırakılan satırların, birleştirilmiş tek bir satırda nasıl birleştirileceğini tanımlayın. Birleştirilen satır gizlilik koşullarını karşılıyorsa birleştirilmiş satır son sonuca dahil edilir.

generateFilteredRowSummaryAutomatically

boolean

Doğruysa, filtrelenen bir satır özeti otomatik olarak oluşturulur.

BirleştirmeÖzellikleri

Analiz sorgu sonucu şeması için talimatları birleştirin.

JSON gösterimi
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
Alanlar
columns

map (key: string, value: object (MergeColumn))

Her bir sütunun birleştirilmesiyle ilgili talimatlar, adla anahtarlanmıştır. Eksik sütunlar, Interop_TYPE_UNSPECIFIED olarak işlenir.

"key": value çift listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Sütunu Birleştir

Tek bir çıkış sütunu için talimatları birleştir.

JSON gösterimi
{
  "type": enum (MergeType),
  "value": {
    object (ParameterValue)
  }
}
Alanlar
type

enum (MergeType)

Sütun değerlerini birleştirmek için kullanılan yöntem.

value

object (ParameterValue)

Kullanılacak sabit değer (yalnızca CONSTANT birleştirme türü için geçerlidir).

Birleştirme Türü

Sütun birleştirme için desteklenen tüm işlemler.

Sıralamalar
MERGE_TYPE_UNSPECIFIED Belirtilmemiş birleştirme türü. Birleştirilmiş sütun değeri NULL olacaktır.
CONSTANT Birleştirilmiş sütun değerini belirtilen sabitle değiştirin.
SUM Birleştirilen sütun değerlerinin toplamını alın.

FiltrelenmişSatırÖzeti

Analiz sorgu sonucu şeması için talimatları birleştirin.

JSON gösterimi
{
  "columns": {
    string: {
      object (ColumnSummaryRule)
    },
    ...
  }
}
Alanlar
columns

map (key: string, value: object (ColumnSummaryRule))

Her bir sütunun birleştirilmesiyle ilgili talimatlar, adla anahtarlanmıştır. Tüm eksik sütunlar SUMMARY_TYPE_UNSPECIFIED olarak değerlendirilir.

"key": value çift listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

SütunÖzet Kuralı

Tek bir çıkış sütunu için talimatları birleştir.

JSON gösterimi
{
  "type": enum (SummaryType),
  "value": {
    object (ParameterValue)
  }
}
Alanlar
type

enum (SummaryType)

Sütun değerlerini birleştirmek için kullanılan yöntem.

value

object (ParameterValue)

Kullanılacak sabit değer (yalnızca CONSTANT özet türü için geçerlidir).

ÖzetTürü

Sütun birleştirme için desteklenen tüm işlemler.

Sıralamalar
SUMMARY_TYPE_UNSPECIFIED Belirtilmemiş özet türü. Özet sütunu değeri NULL olacaktır.
CONSTANT Birleştirilmiş sütun değerini belirtilen sabitle değiştirin.
SUM Birleştirilen sütun değerlerinin toplamını alın.

Yöntemler

create

Daha sonra çalıştırılmak üzere bir analiz sorgusu oluşturur.

delete

Bir analiz sorgusunu siler.

get

İstenen analiz sorgusunu alır.

list

Belirtilen müşteriye ait analiz sorgularını listeler.

patch

Mevcut bir analiz sorgusunu günceller.

start

Depolanan bir analiz sorgusunda yürütmeyi başlatır.

startTransient

Geçici bir analiz sorgusunda yürütme işlemini başlatır.

validate

Sağlanan analiz sorgusunda statik doğrulama kontrolleri gerçekleştirir.