Aracılığıyla paylaş

Faturalanabilir kullanım sistemi tablo başvurusu

  • Makale

Bu makalede, şema ve örnek sorgular da dahil olmak üzere faturalanabilir kullanım sistemi tablosuna genel bir bakış sağlanır. Sistem tablolarında hesabınızın faturalanabilir kullanım verileri merkezi hale getirilir ve tüm bölgelere yönlendirilir, böylece çalışma alanınızın bulunduğu bölgeden hesabınızın genel kullanımını görüntüleyebilirsiniz.

Maliyetleri ve örnek sorguları izlemek için bu tabloyu kullanma hakkında bilgi için bkz. Sistem tablolarını kullanarak maliyetleri izleme.

Tablo yolu: Bu sistem tablosu system.billing.usagekonumunda bulunur.

Faturalanabilir kullanım tablosu şeması

Faturalanabilir kullanım sistemi tablosu aşağıdaki şemayı kullanır:

Sütun adı Veri türü Açıklama Örnek
record_id Dizgi Bu kullanım kaydı için benzersiz kimlik 11e22ba4-87b9-4cc2-9770-d10b894b7118
account_id Dize Bu raporun oluşturulduğu hesabın kimliği 23e22ba4-87b9-4cc2-9770-d10b894b7118
workspace_id Dize Bu kullanımın ilişkilendirildiği çalışma alanının kimliği 1234567890123456
sku_name Dize SKU'nun adı STANDARD_ALL_PURPOSE_COMPUTE
cloud Dize Bu kullanımla ilişkili bulut. Olası değerler AWS, AZUREve GCP. AWS, AZURE veya GCP
usage_start_time timestamp Bu kullanım kaydıyla ilgili başlangıç saati. Saat dilimi bilgileri değerin sonunda UTC saat dilimini temsil eden +00:00 kaydedilir. 2023-01-09 10:00:00.000+00:00
usage_end_time timestamp Bu kullanım kaydıyla ilgili bitiş saati. Saat dilimi bilgileri değerin sonunda UTC saat dilimini temsil eden +00:00 kaydedilir. 2023-01-09 11:00:00.000+00:00
usage_date tarih Kullanım kaydının tarihi, bu alan tarihe göre daha hızlı toplama için kullanılabilir 2023-01-01
custom_tags harita Kullanım kaydıyla ilişkili özel etiketler { “env”: “production” }
usage_unit Dize Bu kullanımın ölçülmüş olduğu birim DBU
usage_quantity ondalık Bu kayıt için kullanılan birim sayısı 259.2958
usage_metadata yapı İşlem kaynakları ve işleri için kimlikler de dahil olmak üzere kullanım hakkında sistem tarafından sağlanan meta veriler (varsa). Bkz. Kullanım Meta Verileri. {cluster_id: null; instance_pool_id: null; notebook_id: null; job_id: null; node_type: null}
identity_metadata yapı Kullanıma dahil olan kimlikler hakkında sistem tarafından sağlanan meta veriler. Bkz. kimlik meta verileri . Kimlik meta verilerine bakın
record_type Dize Kaydın orijinal, geri çekilmiş veya yeniden ifade edilmiş bir kayıt olup olmadığı. Değer, kayıt bir düzeltmeyle ilgili olmadığı sürece ORIGINAL'dir. Bkz. Kayıt Türü. ORIGINAL
ingestion_date tarih Kaydın usage tablosuna alındığı tarih 2024-01-01
billing_origin_product Dize Kullanımı başlatan ürün. Bazı ürünler farklı SKU'lar olarak faturalandırılabilir. Olası değerler için bkz. Ürünü. JOBS
product_features yapı Kullanılan belirli ürün özellikleri hakkındaki ayrıntılar. bkz. Ürün özellikleri. Bkz. Ürün Özellikleri
usage_type Dize Faturalama amacıyla ürüne veya iş yüküne atfedilen kullanım türü. Olası değerler COMPUTE_TIME, STORAGE_SPACE, NETWORK_BYTES, NETWORK_HOUR, API_OPERATION, TOKENveya GPU_TIME. STORAGE_SPACE

Kullanım meta verileri referansı

usage_metadata değerleri, kullanım kaydında yer alan nesneler ve kaynaklar hakkında bilgi verir.

Değer Veri türü Açıklama
cluster_id Dize Kullanım kaydıyla ilişkili kümenin kimliği
warehouse_id Dize Kullanım kaydıyla ilişkili SQL ambarının kimliği
instance_pool_id Dize Kullanım kaydıyla ilişkili örnek havuzunun kimliği
node_type Dize İşlem kaynağının örnek türü
job_id Dize Kullanım kaydıyla ilişkili işin kimliği. Yalnızca sunucusuz işlem veya iş işlem kullanımı için bir değer döndürür, aksi takdirde döndürür null.
job_run_id Dize Kullanım kaydıyla ilişkili iş yürütümünün kimliği. Yalnızca sunucusuz işlem veya iş işlem kullanımı için bir değer döndürür, aksi takdirde döndürür null.
job_name Dize Kullanım kaydıyla ilişkili işin kullanıcı tarafından verilen adı. Yalnızca sunucusuz işlemde çalıştırılacak işler için bir değer döndürür, aksi takdirde döndürür null.
notebook_id Dize Kullanımla ilişkili not defterinin kimliği. Yalnızca not defteri kullanımı için sunucusuz işlem için bir değer döndürür, aksi takdirde döndürür null.
notebook_path Dize Kullanımla ilişkili not defterinin depolandığı çalışma alanı yolu. Yalnızca not defteri kullanımı için sunucusuz işlem için bir değer döndürür, aksi takdirde döndürür null.
dlt_pipeline_id Dize Kullanım kaydıyla ilişkili DLT işlem hattının kimliği
dlt_update_id Dize Kullanım kaydıyla ilişkili DLT güncelleştirmesi işlem hattının ID'si
dlt_maintenance_id Dize Kullanım kaydıyla ilişkili DLT işlem hattı bakım görevlerinin kimliği
run_name Dize Kullanım kaydıyla ilişkili Temel Model İnce Ayarlama'nın kullanıcıya yönelik benzersiz tanımlayıcısı
endpoint_name Dize Kullanım kaydıyla ilişkili uç nokta veya vektör arama uç noktası sunan modelin adı
endpoint_id Dize Kullanım kaydıyla ilişkili uç noktayı veya vektör arama uç noktasını sunan modelin kimliği
central_clean_room_id Dize Kullanım kaydıyla ilişkili merkezi temiz odanın kimliği
source_region Dize Kullanımla ilişkili çalışma alanının bölgesi. Yalnızca ağ ile ilgili maliyetler için bir değer döndürür.
destination_region Dize Erişilmekte olan kaynağın bölgesi. Yalnızca ağ ile ilgili maliyetler için bir değer döndürür.
metastore_id Dize Kullanım kaydıyla ilişkili meta veri deposunun kimliği
app_id Dize Kullanım kaydıyla ilişkili uygulamanın kimliği
app_name Dize Kullanım kaydıyla ilişkili uygulamanın kullanıcı tarafından verilen adı
private_endpoint_name Dize Geçerli özel uç noktanın adı. Yalnızca ağ ile ilgili maliyetler için bir değer döndürür.

Kimlik meta veri referansı

identity_metadata sütunu, kullanıma dahil olan kimlikler hakkında daha fazla bilgi sağlar. run_as alanı, iş yükünü kimin çalıştırdığını günlüğe kaydeder. owned_by alanı yalnızca SQL ambarı kullanımı için geçerlidir ve kullanımdan sorumlu SQL ambarı sahibi olan kullanıcı veya hizmet sorumlusunu günlüğe kaydeder.

Ayrıca Databricks Apps'e atfedilen kullanım, identity_metadata.created_by alanında bir değer kaydediyor. Bu değer, uygulamayı oluşturan kullanıcının e-postasıyla doldurulur.

kimlikleri run_as

identity_metadata.run_as içinde kaydedilen kimlik, kullanım ile ilişkili ürüne bağlıdır. identity_metadata.run_as davranışı için aşağıdaki tabloya başvurun:

İş yükü türü run_as kimliği
İşler işlem Ayarında run_as tanımlanan kullanıcı veya hizmet sorumlusu. Varsayılan olarak, işler iş sahibinin kimliği olarak çalışır, ancak yöneticiler bunu başka bir kullanıcı veya hizmet sorumlusu olarak değiştirebilir.
İşler için sunucusuz işlem run_as ayarında belirlenen kullanıcı veya hizmet sorumlusu. Varsayılan olarak, işler iş sahibinin kimliği olarak çalışır, ancak yöneticiler bunu başka bir kullanıcı veya hizmet sorumlusu olarak değiştirebilir.
Not defterleri için sunucusuz işlem Not defteri komutlarını çalıştıran kullanıcı (özellikle not defteri oturumunu oluşturan kullanıcı). Paylaşılan not defterleri için bu, aynı not defteri oturumunu paylaşan diğer kullanıcıların kullanımını içerir.
DLT veri işlem hatları DLT işlem hattını çalıştırmak için izinleri kullanılan kullanıcı. Bu, hat sahipliği devredilerek değiştirilebilir.
Temel Modelde İnce Ayarlama İnce ayar eğitim çalıştırmasını başlatan kullanıcı veya hizmet sorumlusu.
Tahmine dayalı iyileştirme Tahmine dayalı iyileştirme işlemleri çalıştıran Databricks'e ait hizmet sorumlusu.
Lakehouse sistemi izleme İzleyiciyi oluşturan kullanıcı.

Kayıt türü referansı

billing.usage tablosu düzeltmeleri destekler. Düzeltmeler, kullanım kaydının herhangi bir alanı yanlış olduğunda ve düzeltilmesi gerektiğinde oluşur.

Bir düzeltme gerçekleştiğinde Azure Databricks tabloya iki yeni kayıt ekler. Geri çekme kaydı özgün yanlış kaydı yok eder, sonra bir yeniden ifade kaydı düzeltilen bilgileri içerir. Düzeltme kayıtları şu alan kullanılarak record_type tanımlanır:

  • RETRACTION: Özgün yanlış kullanımı azaltmak için kullanılır. Tüm alanlar, ORIGINAL kaydıyla aynıdır; sadece usage_quantity alanı, özgün kullanım miktarını iptal eden negatif bir değer içerir. Örneğin, özgün kaydın kullanım miktarı ise 259.4356, geri çekme kaydı kullanım miktarına -259.4356sahip olur.
  • RESTATEMENT: Doğru alanları ve kullanım miktarını içeren kayıt.

Örneğin aşağıdaki sorgu, düzeltmeler yapılmış olsa bile ile job_idilgili doğru saatlik kullanım miktarını döndürür. Kullanım miktarını toplayarak, iptal kaydı özgün kaydı geçersiz hale getirir ve yalnızca yeniden ifadenin değerleri döndürülür.

SELECT
  usage_metadata.job_id, usage_start_time, usage_end_time,
  SUM(usage_quantity) as usage_quantity
FROM system.billing.usage
GROUP BY ALL
HAVING usage_quantity != 0

Not

Özgün kullanım kaydının yazılmaması gereken düzeltmeler için, düzeltme yalnızca bir geri çekme kaydı ekleyebilir ve hiçbir yeniden ifade kaydı eklemeyebilir.

Faturalama kaynağı ürün referansı

Bazı Databricks ürünleri aynı paylaşılan SKU kapsamında faturalandırılır. kullanımı ayırt etmeye yardımcı olmak için billing_origin_product ve product_features sütunları, kullanımla ilişkili belirli ürün ve özellikler hakkında daha fazla içgörü sağlar.

billing_origin_product sütunu, kullanım kaydıyla ilişkili Databricks ürününü gösterir. Değerler şunlardır:

  • JOBS
  • DLT
  • SQL
  • ALL_PURPOSE
  • MODEL_SERVING
  • INTERACTIVE
  • DEFAULT_STORAGE
  • VECTOR_SEARCH
  • LAKEHOUSE_MONITORING
  • PREDICTIVE_OPTIMIZATION
  • ONLINE_TABLES
  • FOUNDATION_MODEL_TRAINING
  • AGENT_EVALUATION
  • FINE_GRAIN_ACCESS_CONTROL
  • NETWORKING: Sunucusuz işlemleri özel uç noktalar aracılığıyla kaynaklarınıza bağlamayla ilişkili maliyetler. NETWORKING kullanımı için workspace_idnull, usage_unithourve networking.connectivity_typePRIVATE_IP.
  • APPS: Databricks Apps oluşturma ve çalıştırma maliyetleri

Ürün özellikleri referansı

product_features sütunu, kullanılan belirli ürün özellikleri hakkında bilgi içeren bir nesnedir ve aşağıdaki anahtar/değer çiftlerini içerir:

  • jobs_tier: değerler LIGHT, CLASSICveya null içerir
  • sql_tier: değerler CLASSIC, PROveya null içerir
  • dlt_tier: değerler CORE, PRO, ADVANCEDveya null içerir
  • is_serverless: değerler true veya falseveya null içerebilir
  • is_photon: değerler true veya falseveya null içerebilir
  • serving_type: değerler MODEL, GPU_MODEL, FOUNDATION_MODEL, FEATUREveya null içerir
  • networking.connectivity_type: değerler PUBLIC_IP ve PRIVATE_IP içerir