Dize veri türü

  • Makale

Veri string türü sıfır veya daha fazla Unicode karakterden oluşan bir diziyi temsil eder.

Dize sorgu işleçleri hakkında bilgi için bkz. Dize işleçleri.

Not

  • Dizeler dahili olarak UTF-8 ile kodlanır. Geçersiz (UTF8 olmayan) karakterler alım zamanında U+FFFD Unicode değiştirme karakterleriyle değiştirilir.
  • Kusto'nun tek bir karaktere eşdeğer bir veri türü yoktur. Tek bir karakter, 1 uzunluğunda bir dize olarak temsil edilir.
  • Veri türü alırken string , bir kayıttaki tek bir dize değeri 1 MB'ı aşarsa (UTF-8 kodlaması kullanılarak ölçülür), değer kesilir ve alım başarılı olur. Bir kayıttaki tek bir dize değeri veya kaydın tamamı izin verilen 64 MB veri sınırını aşarsa veri alımı başarısız olur.

string Hazır

Sorgu metnindeki dize değişmez değerlerini kodlamak için çift tırnak veya tek tırnak kullanabilirsiniz. Çift tırnak işaretiyle, ters eğik çizgiyle (\ ) iç içe çift tırnak karakterlerinden kaçış karakteri kullanmanız gerekir. Tek tırnakla, iç içe tek tırnak karakterlerinden kaçış karakteri kullanmanız gerekir ve çift tırnaktan kaçış yapmanız gerekmez.

Tırnak işareti karakterlerini, sekme karakterlerini (), yeni satır karakterlerini ()\t\n ve ters eğik çizginin kendisini (\\ ) atlamak için ters eğik çizgi karakterini kullanın.

Not

Çok satırlı dize değişmez değerleri kullanılmadığı sürece yeni satır karakteri (\n) ve dönüş karakteri (\r) tırnak içine alınmalıdır.

Düz metin dizesi değişmez değerleri

Düz metin dizesi değişmez değerleri de desteklenir. Bu formda, ters eğik çizgi karakteri (\) kendisi anlamına gelir ve bir kaçış karakteri değildir. Karakteri dize değişmez değerlerine önceden eklemek @ , tam bir tanımlayıcı görevi görür. Düz metin dize değişmez değerlerinde, çift tırnaklar çift tırnak işaretiyle, tek tırnaklar ise tek tırnaklarla kaçış karakteriyle kaçış karakterine sahip.

Örnek için bkz. Düz metin dizesi.

Not

Çok satırlı dize değişmez değerleri kullanılmadığı sürece yeni satır karakteri (\n) ve dönüş karakteri (\r) tırnak içine alınmalıdır.

Çok satırlı dize değişmez değerleri

Çok satırlı dize değişmez değerlerini, değişmez değerin başında ve sonunda bir "üçlü backtick akor" (''') ile belirtin.

Bir örnek için bkz . Çok satırlı dize değişmez değeri.

Not

  • Çok satırlı dize değişmez değerleri yeni satır (\n) ve dönüş (\r) karakterlerini destekler.
  • Çok satırlı dize değişmez değerleri kaçış karakterlerini desteklemez. Düz metin dizesi değişmez değerlerine benzer.
  • Çok satırlı dize değişmez değerleri gizlemeyi desteklemez.

Ayrılmış dize değişmez değerlerini birleştirme

Kusto sorgusunda, iki veya daha fazla bitişik dize değişmez değeri aralarında ayrım olmadığında, yeni bir dize değişmez değeri oluşturmak için otomatik olarak birleştirilir. Benzer şekilde, dize değişmez değerleri yalnızca boşluk veya açıklamalarla ayrılırsa, yeni bir dize değişmez değeri oluşturmak için de birleştirilir.

Bir örnek için bkz. Birleştirilmiş dize değişmez değerleri.

Karartılmış dize değişmez değerleri

Sorgular telemetri ve analiz için depolanır. Parolalar ve gizli diziler gibi hassas bilgileri korumak için bir dizeyi karartılmış dize değişmez değeri olarak işaretleyebilirsiniz. Bu işaretli dizeler, sorgu metninde yıldız* () ile değiştirilir.

Karartılmış dize değişmez değeri, standart veya düz metin dizesi değişmez değeri önüne bir h veya H karakteri ön eklenerek oluşturulur.

Örnek için bkz. Karartılmış dize değişmez değeri.

Önemli

Gizli dizi bilgilerini içeren tüm dize değişmez değerlerini karartılmış dize değişmez değerleri olarak işaretleyin.

İpucu

Bazı durumlarda, dize değişmez değerinin yalnızca bir bölümü gizli bilgiler içerir. Bu gibi durumlarda, değişmez değeri gizli olmayan bir bölüme ve gizli bir bölüme bölün. Ardından, yalnızca gizli bölümü karartılmış olarak etiketleyin.

Örnekler

Tırnak işaretleri içeren dize değişmez değeri

Aşağıdaki örnekte, tek tırnaklar ve çift tırnaklar tarafından kapsadığı dize değişmez değerleri içinde tırnakların nasıl kullanılacağı gösterilmektedir. Daha fazla bilgi için bkz . Dize değişmez değerleri.

Sorguyu çalıştır

print
    s1 = 'string with "double quotes"',
    s2 = "string with 'single quotes'"

Çıkış

s1 s2
"çift tırnaklı" dize 'tek tırnaklı' dize

Ters eğik çizgi kaçışlı dize değişmez değeri

Aşağıdaki örnek, özel karakterlerden kurtulmak için ters eğik çizgi kullanarak normal bir ifade deseni oluşturur. Daha fazla bilgi için bkz . Dize değişmez değerleri.

Sorguyu çalıştır

print pattern = '\\n.*(>|\'|=|\")[a-zA-Z0-9/+]{86}=='

Çıkış

Desen
\n.*(>|'|=|") [a-zA-Z0-9/+]{86}=

Unicode ile dize değişmez değeri

Aşağıdaki örnekte, bir dize değişmez değerine Unicode karakteri eklemek için ters eğik çizginin gerekli olduğu gösterilmektedir.

Sorguyu çalıştır

print space = "Hello\u00A0World"

Çıkış

space
Hello World

Düz metin dizesi değişmez değeri

Aşağıdaki örnek, ters eğik çizgilerin kaçış karakterleri yerine yolun bir parçası olduğu bir yol oluşturur. Bunu yapmak için dize @ işareti dizeye eklenir ve düz metin dizesi değişmez değeri oluşturulur.

Sorguyu çalıştır

print myPath = @'C:\Folder\filename.txt'

Çıkış

Mypath
C:\Folder\filename.txt

Çok satırlı dize değişmez değeri

Aşağıdaki örnek, bir kod bloğuna stil eklemek için yeni satırlar ve sekmeler kullanan çok satırlı dize değişmez değerinin söz dizimini gösterir. Daha fazla bilgi için bkz . Çok satırlı dize değişmez değerleri.

Sorguyu çalıştır

print program = ```
  public class Program {
    public static void Main() {
      System.Console.WriteLine("Hello!");
    }
  }```

Çıkış

program
public class Program { public static void Main() { System.Console.WriteLine("Hello!"); } }

Birleştirilmiş dize değişmez değerleri

Aşağıdaki ifadelerin tümü 13 uzunluğunda bir dize verir. Daha fazla bilgi için bkz. Ayrılmış dize değişmez değerlerini birleştirme.

Sorguyu çalıştır

print 
    none = strlen("Hello"', '@"world!"),
    whitespace = strlen("Hello" ', ' @"world!"),
    whitespaceAndComment = strlen("Hello" 
        // Comment
        ', '@"world!"
    );

Çıkış

yok Boşluk whitespaceAndComment
13 13 13

Karartılmış dize değişmez değeri

Aşağıdaki sorgu çıkışında h dize görünür durumdadır. Ancak, izleme veya telemetride h dizenin yerine yıldız işareti eklenir. Daha fazla bilgi için bkz. Karartılmış dize değişmez değerleri.

Sorguyu çalıştır

print blob="https://contoso.blob.core.windows.net/container/blob.txt?"
    h'sv=2012-02-12&se=2013-04-13T0...'

Çıkış

blob
https://contoso.blob.core.windows.net/container/blob.txt?sv=2012-02-12& se=2013-04-13T0...

İlgili içerik