Dize veri türü

Şunlar için geçerlidir: ✅Microsoft Fabric✅Azure Veri Gezgini Azure İzleyiciMicrosoft Sentinel

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'de kodlanır. Geçersiz (UTF8 olmayan) karakterler, alma 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ünü 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.
  • Veri türünü 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. Kodlama ilkesini değiştirerek sütunun sayısını artırabilirsinizMaxValueSize.
  • 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

Dize değişmez değeri, tırnak içine alınmış bir dizedir. 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 çizgi (\ ) ile iç içe çift tırnak karakterlerinden kurtulmanız gerekir. Tek tırnaklarla, iç içe tek tırnak karakterlerinden kurtulmanız gerekir ve çift tırnaklardan kaçış yapmanız gerekmez.

Kapalı tırnak karakterleri, sekme karakterleri (), yeni satır karakterleri (\t\n) ve ters eğik çizginin kendisinden (\\) kurtulmak 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 dize değişmez değerleri, karaktere @ ekli dize değişmez değerleridir ve bu da tam metin tanımlayıcısı görevi görür. Bu formda ters eğik çizgi karakteri (\) kendisi anlamına gelir ve bir kaçış karakteri değildir. Düz metin dize değişmez değerlerinde, çift tırnaklar çift tırnaklarla, tek tırnaklar ise tek tırnaklarla kaçıştır.

Bir ö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 "üç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. Tam dize 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, belirsiz biçimde günlüğe kaydedilir ve yerine sorgu metnindeki yıldız işareti (*) eklenir.

Belirsiz dize değişmez değeri, standart veya düz metin dizesi değişmez değeri önünde bir h veya H karakteri önceden sabitlenerek oluşturulur.

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

Önemli

Gizli bilgi 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 bilgi içerir. Böyle 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 örnek, tek tırnak işaretleri ve çift tırnaklar ile kapsadığı dize değişmez değerleri içinde tırnakların nasıl kullanılacağını gösterir. Daha fazla bilgi için bkz . Dize değişmez değerleri.

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

Çıktı

s1 s2
"çift tırnak" içeren 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 kullanan bir normal ifade deseni oluşturur. Daha fazla bilgi için bkz . Dize değişmez değerleri.

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

Çıktı

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

Unicode ile dize değişmez değeri

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

print space = "Hello\u00A0World"

Çıktı

space
Hello World

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

Aşağıdaki örnek, kaçış karakterleri yerine ters eğik çizgilerin 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.

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

Çıktı

myPath
C:\Folder\filename.txt

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

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

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

Çıktı

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.

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

Çıktı

yok boşluk whitespaceAndComment
13 13 13

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

Aşağıdaki sorgu çıkışında h dize sonuçlarınızda görünür. Ancak, izleme veya telemetride dize h , belirsiz bir biçimde depolanır ve günlükte yıldız işaretiyle değiştirilir. Daha fazla bilgi için bkz . Karartılmış dize değişmez değerleri.

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

Çıktı

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