Dize veri türü
Şunlar için geçerlidir: ✅Microsoft Fabric✅Azure Veri Gezgini✅ Azure İzleyici✅Microsoft 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
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... |