search-Operator
Gilt für: ✅Microsoft Fabric✅✅
Durchsucht ein Textmuster in mehreren Tabellen und Spalten.
Hinweis
Wenn Sie die spezifischen Tabellen und Spalten kennen, die Sie durchsuchen möchten, ist es leistungsfähiger, die Union und die Operatoren zu verwenden. Der search Operator kann bei der Suche über eine große Anzahl von Tabellen und Spalten langsam sein.
Syntax
[T] | [searchkind=CaseSensitivity ] [in(TableSources)] SearchPredicate
Erfahren Sie mehr über Syntaxkonventionen.
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| T | string |
Die tabellarische Datenquelle, die durchsucht werden soll, z. B. einen Tabellennamen, einen Union-Operator oder die Ergebnisse einer tabellarischen Abfrage. Kann nicht zusammen mit TableSources-angegeben werden. | |
| CaseSensitivity | string |
Ein Kennzeichen, das das Verhalten aller string skalaren Operatoren steuert, z has. B. in Bezug auf die Groß-/Kleinschreibung. Gültige Werte sind default, case_insensitive, case_sensitive. Die Optionen default sind synonym, da das Standardverhalten die Groß-/ case_insensitive Kleinschreibung nicht beachtet. |
|
| TableSources | string |
Eine durch Trennzeichen getrennte Liste der Tabellennamen", die an der Suche teilnehmen sollen. Die Liste weist die gleiche Syntax wie die Liste des Union-Operators auf. Kann nicht zusammen mit tabellarischer Datenquelle angegeben werden (T). | |
| SearchPredicate | string |
✔️ | Ein boolescher Ausdruck, der für jeden Datensatz in der Eingabe ausgewertet werden soll. Wenn er zurückgibt true, wird der Datensatz ausgegeben. Siehe Such-Prädikatsyntax. |
Hinweis
Wenn sowohl tabellarische Datenquelle (T) als auch TableSources- weggelassen werden, wird die Suche über alle uneingeschränkten Tabellen und Ansichten der Datenbank im Bereich übertragen.
Such-Prädikatsyntax
Mit SearchPredicate können Sie in allen Spalten einer Tabelle nach bestimmten Begriffen suchen. Der Operator, der auf einen Suchbegriff angewendet wird, hängt vom Vorhandensein und der Platzierung eines Platzhalter-Sternchens (*) im Ausdruck ab, wie in der folgenden Tabelle dargestellt.
| Literal | Operator |
|---|---|
billg |
has |
*billg |
hassuffix |
billg* |
hasprefix |
*billg* |
contains |
bi*lg |
matches regex |
Sie können die Suche auch auf eine bestimmte Spalte beschränken, nach einer exakten Übereinstimmung anstelle einer Ausdrucksausstimmung suchen oder nach regulärem Ausdruck suchen. Die Syntax für jeden dieser Fälle wird in der folgenden Tabelle gezeigt.
| Syntax | Erklärung |
|---|---|
ColumnName:StringLiteral |
Diese Syntax kann verwendet werden, um die Suche auf eine bestimmte Spalte einzuschränken. Das Standardverhalten besteht darin, alle Spalten zu durchsuchen. |
ColumnName==StringLiteral |
Diese Syntax kann verwendet werden, um nach exakten Übereinstimmungen einer Spalte mit einem Zeichenfolgenwert zu suchen. Das Standardverhalten besteht darin, nach einer Ausdrucksversprechung zu suchen. |
Columnmatches regexStringLiteral |
Diese Syntax gibt den Regulären Ausdrucksabgleich an, in dem StringLiteral das regex-Muster ist. |
Verwenden Sie boolesche Ausdrücke, um Bedingungen zu kombinieren und komplexere Suchvorgänge zu erstellen. Würde z "error" and x==123 . B. eine Suche nach Datensätzen mit dem Ausdruck error in allen Spalten und dem Wert 123 in der x Spalte ergeben.
Beispiele für Such-Prädikatsyntax
| # | Syntax | Bedeutung (Äquivalent where) |
Kommentare |
|---|---|---|---|
| 1 | search "err" |
where * has "err" |
|
| 2 | search in (T1,T2,A*) "err" |
Union T1,T2,A* | wobei * hat "err" |
|
| 3 | search col:"err" |
where col has "err" |
|
| 4 | search col=="err" |
where col=="err" |
|
| 5 | search "err*" |
where * hasprefix "err" |
|
| 6 | search "*err" |
where * hassuffix "err" |
|
| 7 | search "*err*" |
where * contains "err" |
|
| 8 | search "Lab*PC" |
where * matches regex @"\bLab.*PC\b" |
|
| 9 | search * |
where 0==0 |
|
| 10 | search col matches regex "..." |
where col matches regex "..." |
|
| 11 | search kind=case_sensitive |
Bei allen Zeichenfolgenvergleichen wird zwischen Groß- und Kleinschreibung unterschieden. | |
| 12 | search "abc" and ("def" or "hij") |
where * has "abc" and (* has "def" or * has hij") |
|
| 13 | search "err" or (A>a and A<b) |
where * has "err" or (A>a and A<b) |
Hinweise
Im Gegensatz zum Suchoperatorunterstützt der search-Operator die folgende Syntax nicht:
-
withsource=: Die Ausgabe enthält immer eine Spalte namens$tablevom Typstring, deren Wert der Tabellenname ist, aus dem jeder Datensatz abgerufen wurde (oder einige vom System generierte Namen, wenn die Quelle keine Tabelle, sondern ein zusammengesetzter Ausdruck ist). -
project=,project-smart: Das Ausgabeschema entspricht demproject-smartAusgabeschema.
Beispiele
Das Beispiel in diesem Abschnitt zeigt, wie Sie die Syntax verwenden, um Ihnen bei den ersten Schritten zu helfen.
In den Beispielen in diesem Artikel werden öffentlich verfügbare Tabellen in der Hilfecluster-verwendet, z. B. die tabelle
StormEventsin der datenbank Beispiele.
In den Beispielen in diesem Artikel werden öffentlich verfügbare Tabellen verwendet, z. B. die Tabelle
StormEventsin der Wetteranalyse Beispieldaten.
Globale Ausdruckssuche
Suchen Sie in allen Tabellen der ContosoSales Datenbank nach dem Begriff "Grün".
Die Ausgabe findet Datensätze mit dem Begriff Green als Nachnamen oder farbe in den Tabellen Customers, Productsund SalesTable.
search "Green"
Ausgabe-
| $table | Ortsname | Kontinentname | CustomerKey | Bildung | Vorname | Geschlecht | Nachname |
|---|---|---|---|---|---|---|---|
| Kundschaft | Ballard | Nordamerika | 16549 | Partielles College | Maurer | M | Grün |
| Kundschaft | Bellingham | Nordamerika | 2070 | Oberschule | Adam | M | Grün |
| Kundschaft | Bellingham | Nordamerika | 10658 | Junggesellenabschied | Sara | F | Grün |
| Kundschaft | Beverly Hills | Nordamerika | 806 | Graduiertenabschluss | Richard | M | Grün |
| Kundschaft | Beverly Hills | Nordamerika | 7674 | Graduiertenabschluss | James | M | Grün |
| Kundschaft | Burbank | Nordamerika | 5241 | Graduiertenabschluss | Madeline | F | Grün |
Bedingte globale Ausdruckssuche
Suchen Sie nach Datensätzen, die den Begriff Green enthalten, und eines der Begriffe Deluxe oder Proseware- in der ContosoSales Datenbank.
search "Green" and ("Deluxe" or "Proseware")
Ausgabe-
| $table | ProductName | Hersteller | ColorName | ClassName | ProductCategoryName |
|---|---|---|---|---|---|
| Produkte | Contoso 8GB Uhr & Radio MP3 Player X850 Grün | Contoso, Ltd | Grün | Luxus | Audio |
| Produkte | Proseware Scan Jet Digital Flat Bed Scanner M300 Green | Proseware, Inc. | Grün | Regelmäßig | Computer |
| Produkte | Proseware All-In-One Fotodrucker M200 Grün | Proseware, Inc. | Grün | Regelmäßig | Computer |
| Produkte | Proseware Ink Jet Wireless All-In-One Drucker M400 Grün | Proseware, Inc. | Grün | Regelmäßig | Computer |
| Produkte | Proseware Ink Jet Instant PDF Sheet-Fed Scanner M300 Green | Proseware, Inc. | Grün | Regelmäßig | Computer |
| Produkte | Proseware Desk Jet All-in-One-Drucker, Scanner, Kopierer M350 Grün | Proseware, Inc. | Grün | Regelmäßig | Computer |
| Produkte | Proseware Duplexscanner M200 Grün | Proseware, Inc. | Grün | Regelmäßig | Computer |
Durchsuchen einer bestimmten Tabelle
Suchen Sie nur in der Customers Tabelle nach dem Begriff Green.
search in (Products) "Green"
Ausgabe-
| $table | ProductName | Hersteller | ColorName |
|---|---|---|---|
| Produkte | Contoso 4G MP3 Player E400 Green | Contoso, Ltd | Grün |
| Produkte | Contoso 8GB Super-Slim MP3/Video Player M800 Grün | Contoso, Ltd | Grün |
| Produkte | Contoso 16GB Mp5 Player M1600 Grün | Contoso, Ltd | Grün |
| Produkte | Contoso 8GB Uhr & Radio MP3 Player X850 Grün | Contoso, Ltd | Grün |
| Produkte | NT Wireless Bluetooth Stereo Headphones M402 Grün | Northwind Traders | Grün |
| Produkte | NT Wireless Sender und Bluetooth Headphones M150 Green | Northwind Traders | Grün |
Suche unter Beachtung der Groß-/Kleinschreibung
Suchen Sie nach Datensätzen, die mit dem Begriff "Groß-/Kleinschreibung" in der "ContosoSales" Datenbank übereinstimmen.
search kind=case_sensitive "blue"
Ausgabe-
| $table | ProductName | Hersteller | ColorName | ClassName |
|---|---|---|---|---|
| Produkte | Contoso 16GB Neue Generation MP5 Player M1650 blau | Contoso, Ltd | blau | Regelmäßig |
| Produkte | Contoso Bright Light Akku E20 blau | Contoso, Ltd | blau | Wirtschaft |
| Produkte | Litware 120mm Blue LED Case Lüfter E901 blau | Litware, Inc. | blau | Wirtschaft |
| NewSales | Litware 120mm Blue LED Case Lüfter E901 blau | Litware, Inc. | blau | Wirtschaft |
| NewSales | Litware 120mm Blue LED Case Lüfter E901 blau | Litware, Inc. | blau | Wirtschaft |
| NewSales | Litware 120mm Blue LED Case Lüfter E901 blau | Litware, Inc. | blau | Wirtschaft |
| NewSales | Litware 120mm Blue LED Case Lüfter E901 blau | Litware, Inc. | blau | Wirtschaft |
Bestimmte Spalten durchsuchen
Suchen Sie nach den Begriffen Aaron und Hughesin den Spalten "Vorname" bzw. "Nachname" in der datenbank ContosoSales.
search FirstName:"Aaron" or LastName:"Hughes"
Ausgabe-
| $table | CustomerKey | Bildung | Vorname | Geschlecht | Nachname |
|---|---|---|---|---|---|
| Kundschaft | 18285 | Oberschule | Riley | F | Hughes |
| Kundschaft | 802 | Graduiertenabschluss | Aaron | M | Sharma |
| Kundschaft | 986 | Junggesellenabschied | Melanie | F | Hughes |
| Kundschaft | 12669 | Oberschule | Jessica | F | Hughes |
| Kundschaft | 13436 | Graduiertenabschluss | Mariah | F | Hughes |
| Kundschaft | 10152 | Graduiertenabschluss | Aaron | M | Campbell |
Einschränken der Suche nach Zeitstempel
Suchen Sie nach dem Begriff Hughes in der ContosoSales Datenbank, wenn der Begriff in einem Datensatz mit einem Datum angezeigt wird, das größer als das angegebene Datum in "datetime" ist.
search "Hughes" and DateKey > datetime('2009-01-01')
Ausgabe-
| $table | DateKey | SalesAmount_real |
|---|---|---|
| SalesTable | 2021-12-13T00:00:00Z | 446.4715 |
| SalesTable | 2021-12-13T00:00:00Z | 120.555 |
| SalesTable | 2021-12-13T00:00:00Z | 48.4405 |
| SalesTable | 2021-12-13T00:00:00Z | 39.6435 |
| SalesTable | 2021-12-13T00:00:00Z | 56.9905 |
Tipps zur Leistungssteigerung
| # | Tipp | Bevorzugt | Over |
|---|---|---|---|
| 1 | Verwenden Sie lieber einen einzelnen search Operator über mehrere aufeinander folgende search Operatoren. |
search "billg" and ("steveb" or "satyan") |
suchen "billg" | suche "steveb" oder "satyan" |
| 2 | Bevorzugen Sie es, innerhalb des search Operators zu filtern |
search "billg" and "steveb" |
search * | wobei * hat "billg" und * hat "steveb" |