Share via

A sztring adattípusa

  • Cikk

Az string adattípus nulla vagy több Unicode-karakterből álló sorozatot jelöl.

A sztringlekérdezés operátorairól további információt a Sztringoperátorok című témakörben talál.

Megjegyzés

  • A sztringek belső kódolása UTF-8. Az érvénytelen (nem UTF8) karaktereket A betöltéskor U+FFFD Unicode helyettesítő karakterek váltják fel.
  • A Kusto nem rendelkezik egyetlen karakterrel egyenértékű adattípussal. Egyetlen karakter 1 hosszúságú sztringként jelenik meg.
  • Az adattípus betöltésekor string , ha egy rekord egyetlen sztringértéke meghaladja az 1 MB-ot (UTF-8 kódolással mérve), az érték csonkul, és a betöltés sikeres lesz. Ha egy rekord vagy a teljes rekord egyetlen sztringértéke meghaladja a megengedett 64 MB-os adatkorlátot, a betöltés sikertelen lesz.

string Literálok

A lekérdezés szövegében sztringkonstansokat kódolhat idézőjelek vagy szimpla idézőjelek használatával. Dupla idézőjelek esetén meg kell szabadulnia a beágyazott idézőjelek karakterei elől fordított perjellel (\). Az egyszeres idézőjelek esetén meg kell szabadulnia a beágyazott idézőjelek karakterei elől, és nem kell feloldania a dupla idézőjeleket.

Használja a fordított perjel karaktert az idézőjelek, a tabulátorkarakterek (), az újsoros karakterek (\t\n) és maga a fordított perjel (\\) feloldásához.

Megjegyzés

Az újsoros karaktert (\n) és a visszatérési karaktert (\r) idézőjelek közé kell tenni, kivéve , ha többsoros sztringkonstansokat használ.

Verbatim sztringkonstansok

A verbatim sztringkonstansok is támogatottak. Ebben a formában a fordított perjel karakter (\) önmagát jelöli, és nem feloldó karakter. A karakter sztringkonstansokra való előtagolása @ szó szerinti azonosítóként szolgál. A szó szerinti sztringkonstansokban a dupla idézőjelek dupla idézőjelekkel, az egyszeres idézőjelek pedig szimpla idézőjelekkel vannak feloldva.

Példa: Verbatim sztring.

Megjegyzés

Az újsoros karaktert (\n) és a visszatérési karaktert (\r) idézőjelek közé kell tenni, kivéve , ha többsoros sztringkonstansokat használ.

Többsoros sztringkonstansok

Jelöljön egy többsoros sztringkonstansokat a literál elején és végén egy "triple-backtick chord" ('' ) használatával.

Példa: Többsoros sztringkonstans.

Megjegyzés

  • A többsoros sztringkonstansok támogatják a newline (\n) és a return (\r) karaktereket.
  • A többsoros sztringkonstansok nem támogatják a feloldott karaktereket. Hasonló a szó szerinti sztringkonstansokhoz.
  • A többsoros sztringkonstansok nem támogatják az elfedést.

Elválasztott sztringkonstansok összefűzése

Ha egy Kusto-lekérdezésben két vagy több szomszédos sztringkonstans nem különül el egymástól, a rendszer automatikusan kombinálja őket egy új sztringkonstans létrehozásához. Hasonlóképpen, ha a sztringkonstansokat csak térközök vagy megjegyzések választják el egymástól, akkor ezek is egy új sztringkonstans létrehozásához lesznek kombinálva.

Példa: Összefűzött sztringkonstansok.

Elfedt sztringkonstansok

A lekérdezések telemetriai és elemzési célokra vannak tárolva. A bizalmas információk, például a jelszavak és a titkos kódok védelme érdekében a sztringeket elrejtett sztringkonstansként jelölheti meg. Ezeket a megjelölt sztringeket csillag (*) váltja fel a lekérdezés szövegében.

Az obfuscated sztringkonstans egy szabványos vagy H szó szerinti sztringkonstans elé történő előtagolásával h jön létre.

Egy példa: Obfuscated sztringkonstans.

Fontos

Jelölje meg az összes olyan sztringkonstanst, amely titkos adatokat tartalmaz, rejtjelezett sztringkonstansként.

Tipp

Bizonyos helyzetekben a sztringkonstansnak csak egy része tartalmaz titkos információkat. Ilyen esetekben ossza fel a literált egy nem titkos részre és egy titkos részre. Ezután csak a titkos részt címkézze el rejtve.

Példák

Sztringkonstans idézőjelekkel

Az alábbi példa bemutatja, hogyan használhatók az idézőjelek a sztringkonstansokban, és hogyan használhatók az idézőjelek és a dupla idézőjelek. További információ: Sztringkonstansok.

A lekérdezés futtatása

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

Kimenet

s1 s2
sztring "dupla idézőjelekkel" sztring "szimpla idézőjelekkel"

Sztringkonstans fordított perjellel

Az alábbi példa egy reguláris kifejezésmintát hoz létre fordított perjelek használatával a speciális karakterek feloldásához. További információ: Sztringkonstansok.

A lekérdezés futtatása

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

Kimenet

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

Sztringkonstans Unicode-tal

Az alábbi példa azt mutatja be, hogy fordított perjelre van szükség ahhoz, hogy Unicode-karakter szerepeljen egy sztringkonstansban.

A lekérdezés futtatása

print space = "Hello\u00A0World"

Kimenet

Hely
Hello World

Verbatim sztringkonstans

Az alábbi példa egy elérési utat hoz létre, amelyben a fordított perjelek a feloldókarakterek helyett az elérési út részét képezik. Ehhez a sztring előtagja a sztringre @ van felfűzve, létrehozva egy szó szerinti sztringkonstanst.

A lekérdezés futtatása

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

Kimenet

myPath
C:\Folder\filename.txt

Többsoros sztringkonstans

Az alábbi példa egy többsoros sztringkonstans szintaxisát mutatja be, amely új vonalakat és füleket használ a kódblokkok stílusához. További információ: Többsoros sztringkonstansok.

A lekérdezés futtatása

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

Kimenet

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

Összefűzött sztringkonstansok

Az alábbi kifejezések mindegyike 13 hosszúságú sztringet eredményez. További információ: Elválasztott sztringkonstansok összefűzése.

A lekérdezés futtatása

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

Kimenet

Nincs Szóköz whitespaceAndComment
13 13 13

Elfedt sztringkonstans

A következő lekérdezési kimenetben a sztring h látható. A nyomkövetés vagy a telemetria esetében azonban a h sztring csillagokkal van helyettesítve. További információ: Elfedt sztringkonstansok.

A lekérdezés futtatása

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

Kimenet

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

Kapcsolódó tartalom