Freigeben über


IDataView.GetRowCursorSet Methode

Definition

Dadurch wird eine Reihe paralleler Batchcursor erstellt. Der Wert ist ein empfohlener Grenzwert n für Kardinalität. Wenn n dies nicht positiv ist, gibt dies an, dass der Aufrufer keine Empfehlung hat, und die Implementierung sollte ein Standardverhalten aufweisen, um diesen Fall abzudecken. Beachten Sie, dass dies streng eine Empfehlung ist: Es ist völlig möglich, dass eine Implementierung eine andere Anzahl von Cursorn zurückgeben kann.

Die Cursor sollten dieselben Daten zurückgeben, die GetRowCursor(IEnumerable<DataViewSchema.Column>, Random)durch zurückgegeben werden, außer partitioniert: Keine zwei Cursor sollten die "gleiche" Zeile zurückgeben, wie durch den regulären seriellen Cursor zurückgegeben worden wäre, aber alle Zeilen sollten von genau einem der von diesem Cursor zurückgegebenen Cursor zurückgegeben werden. Die Cursor können ihre Werte über die Verwendung der Batch Eigenschaft nachgeschaltet haben.

Das typische Verwendungsmuster besteht darin, dass eine Reihe von Cursorn angefordert wird, jede von ihnen wird dann einer Reihe von Arbeitsthreads zugewiesen, die von ihnen unabhängig genutzt werden, während die Ergebnisse letztendlich am Ende sortiert werden, indem die Reihenfolge der Batch oben beschriebenen Eigenschaft ausgenutzt wird. Typische Szenarien sind Inhalte mit Pulling aus dem einzelnen seriellen Cursor von GetRowCursor(IEnumerable<DataViewSchema.Column>, Random).

public Microsoft.ML.DataViewRowCursor[] GetRowCursorSet (System.Collections.Generic.IEnumerable<Microsoft.ML.DataViewSchema.Column> columnsNeeded, int n, Random rand = default);
abstract member GetRowCursorSet : seq<Microsoft.ML.DataViewSchema.Column> * int * Random -> Microsoft.ML.DataViewRowCursor[]
Public Function GetRowCursorSet (columnsNeeded As IEnumerable(Of DataViewSchema.Column), n As Integer, Optional rand As Random = Nothing) As DataViewRowCursor()

Parameter

columnsNeeded
IEnumerable<DataViewSchema.Column>

Die aktiven Spalten sind erforderlich. Wenn eine leere IEnumerable Spalte übergeben wird, wird keine Spalte angefordert.

n
Int32

Der vorgeschlagene Grad des Parallelismus.

rand
Random

Eine Instanz, um Random den Zugriff zufällig zu erstellen.

Gibt zurück

Gilt für: