Zeilen mit OData sortieren
Verwenden Sie die $orderby Abfrageoption , um die Reihenfolge anzugeben, in der Artikel zurückgegeben werden. Verwenden Sie das Suffix asc oder desc, um eine aufsteigende bzw. absteigende Reihenfolge anzugeben. Die Standardeinstellung ist aufsteigend. Das folgende Beispiel ruft die Eigenschaften name und revenue von Konten ab, geordnet nach aufsteigender revenue und absteigender name:
GET [Organization URI]/api/data/v9.2/accounts?$select=name,revenue
&$orderby=revenue asc,name desc
&$filter=revenue ne null
Such- und Auswahlspalten ordnen
Die in den meisten Spaltentypen enthaltenen Daten sind relativ einfach und Sie können sinnvolle Sortiervorgänge durchführen. Such- und Auswahlspalten sind komplexer, da die in der Datenbank gespeicherten Daten außerhalb des Kontexts keine Bedeutung haben.
Suchspalten
Wenn Sie mithilfe von Suchspalten ordnen, werden die Ergebnisse anhand des primären Namensfelds für die zugehörige Tabelle sortiert. Die Datenbank speichert einen GUID-Wert. Der zurückgegebene formatierte Wert ist das entsprechende Feld des primären Namens.
Auswahlspalten
Wenn Sie nach Auswahlspalten sortieren, werden die Ergebnisse nach dem ganzzahligen Wert der Auswahl sortiert.
Hinweis
Dies unterscheidet sich von der Sortierung von Auswahlwerten mit FetchXml oder QueryExpression. In diesen Fällen werden die Ergebnisse nach der lokalisierten Bezeichnung für die Auswahl sortiert.
Um die Ergebnisse mit der Dataverse Web-API nach Auswahlbeschriftungen zu sortieren, müssen Sie zum Erstellen der Abfrage FetchXml verwenden.
Anordnung und Auslagerung
Die Reihenfolge einer Seite macht beim Auslagern von Daten einen großen Unterschied. Wenn die Informationen zur Reihenfolge der Ergebnisse nicht eindeutig sind, kann Dataverse ausgelagerte Daten nicht konsistent oder effizient zurückgeben.
Geben Sie eine Reihenfolge für Ihre Abfrage an. Wenn Sie bei FetchXml Ihrer Abfrage keine Sortierelemente hinzufügen, fügt Dataverse eine Sortierung basierend auf dem Primärschlüssel der Tabelle hinzu. Dies ist bei QueryExpression jedoch nicht der Fall. Wenn Ihre Abfrage distinct-Ergebnisse angibt, werden außerdem keine Primärschlüsselwerte zurückgegeben, weshalb Dataverse diese Standardreihenfolge nicht hinzufügen kann. Sie müssen eine Auslagerungsreihenfolge angeben. Ohne Angabe einer Reihenfolge werden distinct-Abfrageergebnisse möglicherweise in zufälliger Reihenfolge zurückgegeben. OData bietet keine Option zum Zurückgeben unterschiedlicher Ergebnisse. Sie sollten beim Abrufen ausgelagerter Ergebnisse jedoch trotzdem eine Reihenfolge anwenden.
Die Auslagerung ist dynamisch. Jede Anforderung wird bei Eingang einzeln bewertet. Ein Auslagerungs-Cookie teilt Dataverse die vorherige Seite mit. Mit diesen Auslagerungs-Cookie-Daten kann Dataverse mit dem nächsten Datensatz nach dem letzten auf der vorherigen Seite beginnen.
Die Auslagerung funktioniert zukünftig am besten. Wenn Sie zurückgehen und eine Seite abrufen, die Sie zuvor abgerufen haben, können die Ergebnisse unterschiedlich sein, da seit dem letzten Abruf der Seite Datensätze hinzugefügt, gelöscht oder geändert werden konnten. Mit anderen Worten: Wenn Ihre Seitengröße 50 beträgt und Sie zurückgehen, erhalten Sie 50 Datensätze, es handelt sich jedoch möglicherweise nicht um dieselben 50 Datensätze. Wenn Sie die Seiten eines Dataset weiter durchgehen, können Sie davon ausgehen, dass alle Datensätze in einer konsistenten Reihenfolge zurückgegeben werden.
Die deterministische Sortierung ist wichtig
Deterministische Reihenfolge bedeutet, dass es eine Möglichkeit gibt, eine Reihenfolge konsistent zu berechnen. Bei einem bestimmten Datensatzsatz werden die Datensätze immer in derselben Reihenfolge zurückgegeben. Wenn Sie eine einheitliche Reihenfolge und ein Paging benötigen, müssen Sie einige eindeutige Werte oder Kombinationen aus Spaltenwerten einschließen und eine Reihenfolge angeben, in der sie ausgewertet werden sollen.
Nichtdeterministisches Beispiel
Schauen wir uns ein Beispiel an, das nichtdeterministisch ist. Dieses Dataset enthält nur Status und Status-Informationen und ist gefiltert, um nur Datensätze in einem offenen Status zurückzugeben. Die Ergebnisse sind nach Status geordnet. Die ersten drei Seiten werden angefordert. Die Ergebnisse sehen folgendermaßen aus:
| Bundesstaat | Status | Seite |
|---|---|---|
| Eröffnung | Aktiv | 1 Start |
| Eröffnung | Aktiv | 1 |
| Eröffnung | Aktiv | 1 Ende |
| Eröffnung | Aktiv | |
| Eröffnung | Aktiv | |
| Eröffnung | Inaktiv | |
| Eröffnung | Inaktiv |
Das Auslagerungs-Cookie speichert Informationen über den letzten Datensatz auf der Seite. Wenn die nächste Seite angefordert wird, ist der letzte Datensatz der ersten Seite nicht enthalten. Aufgrund der nichtdeterministischen Daten gibt es jedoch keine Garantie dafür, dass die beiden anderen Datensätze auf der ersten Seite nicht auf der zweiten Seite enthalten sind.
Um eine deterministische Reihenfolge zu erreichen, fügen Sie Reihenfolgen für Spalten hinzu, die eindeutige oder halbeindeutige Werte enthalten.
Deterministisches Beispiel
Diese Abfrage ähnelt der nichtdeterministischen Abfrage, enthält jedoch die Spalte Fall-ID, die eindeutige Werte enthält. Es wird auch nach Status, aber auch nach Fall-ID sortiert. Die Ergebnisse sehen folgendermaßen aus:
| Bundesstaat | Status | Fall-ID | Seite |
|---|---|---|---|
| Eröffnung | Aktiv | Case-0010 | 1 Start |
| Eröffnung | Aktiv | Case-0021 | 1 |
| Eröffnung | Aktiv | Case-0032 | 1 Ende |
| Eröffnung | Aktiv | Case-0034 | |
| Eröffnung | Aktiv | Case-0070 | |
| Eröffnung | Inaktiv | Case-0015 | |
| Eröffnung | Inaktiv | Case-0047 |
Auf der nächsten Seite hat das Cookie Case-0032 als letzten Datensatz auf der ersten Seite gespeichert, sodass Seite zwei mit dem nächsten Datensatz nach diesem Datensatz startet. Die Ergebnisse sehen folgendermaßen aus:
| Bundesstaat | Status | Fall-ID | Seite |
|---|---|---|---|
| Eröffnung | Aktiv | Case-0010 | 1 Start |
| Eröffnung | Aktiv | Case-0021 | 1 |
| Eröffnung | Aktiv | Case-0032 | 1 Ende |
| Eröffnung | Aktiv | Case-0034 | 2 Start |
| Eröffnung | Aktiv | Case-0070 | 2 |
| Eröffnung | Inaktiv | Case-0015 | 2 Ende |
| Eröffnung | Inaktiv | Case-0047 |
Da diese Abfrage eindeutige Spaltenwerte anordnet, ist die Reihenfolge konsistent.
Best Practices für Reihenfolgen beim Auslagern von Daten
Hinweis
Wenn möglich, sollten Abfragen nach dem Primärschlüssel für die Tabelle sortiert werden, da Dataverse standardmäßig für die Sortierung nach dem Primärschlüssel optimiert ist. Die Sortierung nach nicht eindeutigen oder komplexen Feldern führt zu übermäßigem Overhead und langsameren Abfragen.
Wenn Sie einen begrenzten Satz von Daten zur Anzeige in einer Anwendung abrufen oder mehr als 5.000 Datenzeilen zurückgeben müssen, müssen Sie die Ergebnisse auslagern. Die Auswahl, die Sie bei der Bestimmung der Reihenfolge der Ergebnisse treffen, kann bestimmen, ob sich die Zeilen auf jeder von Ihnen abgerufenen Datenseite mit anderen Seiten überschneiden. Ohne die richtige Reihenfolge kann derselbe Datensatz auf mehr als einer Seite erscheinen.
Um zu verhindern, dass derselbe Datensatz auf mehr als einer Seite erscheint, wenden Sie die folgenden Best Practices an:
Am besten fügen Sie eine Spalte mit einem eindeutigen Bezeichner ein. Zum Beispiel:
- Spalten für Primärschlüssel der Tabellen
- AutoWert-Spalten
- Benutzer-/Kontakt-IDs
Wenn Sie keine Spalte mit einem eindeutigen Bezeichner einschließen können, schließen Sie mehrere Felder ein, die höchstwahrscheinlich zu eindeutigen Kombinationen führen. Zum Beispiel:
- Vorname + Nachname + E-Mail-Adresse
- Vollständiger Name + E-Mail-Adresse
- E-Mail-Adresse + Firmenname
Anti-Muster für Reihenfolgen beim Auslagern von Daten
Die folgenden Auswahlmöglichkeiten für die Sortierung sollten Sie vermeiden:
Sortierungen ohne eindeutige Bezeichner
Sortierungen in berechneten Feldern
Sortierungen mit einzelnen oder mehreren Feldern, die wahrscheinlich keine Eindeutigkeit bieten, wie:
- Status und Zustand
- Auswahlmöglichkeiten oder Ja/Nein
- Namenswerte allein. Zum Beispiel
name,firstname,lastname - Textfelder wie Titel, Beschreibungen und mehrzeiliger Text
- Nicht eindeutige Nummernfelder
Nächste Schritte,
Erfahren Sie, wie Zeilen gefiltert werden.
Hinweis
Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)
Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).