ResolveChoice-Klasse

Löst einen Auswahltyp innerhalb eines DynamicFrame auf.

Beispiel

Wir empfehlen, dass Sie die DynamicFrame.resolveChoice()-Methode verwenden, um Felder zu behandeln, die mehrere Typen in einem DynamicFrame enthalten. Code-Beispiele finden Sie unter Beispiel: Verwenden Sie ResolveChoice, um eine Spalte zu behandeln, die mehrere Typen enthält.

Methoden

• __call__

• apply

• Name

• describeArgs

• describeReturn

• describeTransform

• describeErrors

• Beschreiben

__call__(frame, specs = None, choice = "", transformation_ctx = "", info = "", stageThreshold = 0, totalThreshold = 0)

Stellt Informationen zum Auflösen mehrdeutiger Typen innerhalb eines DynamicFrame bereit. Gibt den resultierenden DynamicFrame zurück.

• frame – Der DynamicFrame, in dem der Auswahltyp aufgelöst werden soll (erforderlich).

• specs – Eine Liste der aufzulösenden spezifischen Mehrdeutigkeiten, jede in Form eines Tupels:(path, action). Der path-Wert identifiziert ein spezielles mehrdeutiges Element und der action-Wert identifiziert die entsprechende Auflösung.

  Sie können nur einen der Parameter spec und choice verwenden. Wenn der spec-Parameter nicht None ist, dann muss der choice-Parameter eine leere Zeichenfolge sein. Wenn umgekehrt der choice-Parameter keine leere Zeichenfolge ist, dann muss der spec-Parameter None sein. Wenn keine Parameter angegeben werden, versucht AWS Glue, das Schema zu analysieren und es für die Auflösung von Mehrdeutigkeiten zu verwenden.

  Sie können eine der folgenden Auflösungsstrategien im action-Teil eines specs-Tupels angeben:

  • cast – Ermöglicht Ihnen, einen Typ anzugeben, in den umgewandelt werden soll (z. B. cast:int).

  • make_cols – Löst eine potenzielle Mehrdeutigkeit durch Vereinfachen der Daten auf. Wenn columnA beispielsweise int oder string sein könnte, besteht die Auflösung darin, zwei Spalten mit den Namen columnA_int und columnA_string im resultierenden DynamicFrame zu erzeugen.

  • make_struct – Löst eine potenzielle Mehrdeutigkeit durch Verwendung einer Struktur, um die Daten darzustellen. Wenn beispielsweise Daten in einer Spalte int oder string sein könnten, wird durch Verwendung der make_struct-Aktion eine Spalte von Strukturen im resultierenden DynamicFrame erzeugt, die sowohl ein int als auch ein string enthalten.

  • project – Löst eine potenzielle Mehrdeutigkeit auf, indem nur Werte eines bestimmten Typs in dem resultierenden DynamicFrame beibehalten werden. Wenn beispielsweise Daten in einer ChoiceType-Spalte ein int oder eine string sein könnten, werden bei der Angabe einer project:string-Aktion Werte aus dem resultierenden DynamicFrame ausgelassen, die nicht vom Typ string sind.

  Wenn path ein Array identifiziert, platzieren Sie leere eckige Klammern hinter dem Namen des Arrays, um eine Mehrdeutigkeit zu vermeiden. Angenommen, Sie arbeiten mit Daten, die wie folgt strukturiert sind:

  "myList": [
    { "price": 100.00 },
    { "price": "$100.00" }
  ]

  Sie können anstelle der Zeichenfolgenversion die numerische Version des Preises auswählen, indem Sie den path auf "myList[].price" und die action auf "cast:double" setzen.

• choice – Die standardmäßige Auflösungsaktion, wenn der specs-Parameter None ist. Wenn der specs-Parameter nicht None ist, dann darf dies nur auf eine leere Zeichenfolge festgelegt werden.

  Zusätzlich zu den soeben beschriebenen specs-Aktionen unterstützt dieses Argument noch die folgende Aktion:

  • MATCH_CATALOG – Versucht jeden ChoiceType in einen entsprechenden Typ in der angegebenen Data-Catalog-Tabelle umzuwandeln.

• database – Die Datenbank von AWS Glue Data Catalog zur Verwendung mit der MATCH_CATALOG-Auswahl (erforderlich für MATCH_CATALOG).

• table_name – Der Tabellenname von AWS Glue Data Catalog zur Verwendung mit der MATCH_CATALOG-Aktion (erforderlich für MATCH_CATALOG).

• transformation_ctx – Eine eindeutige Zeichenfolge zur Identifikation von Statusinformationen (optional).

• info – Eine Zeichenfolge im Zusammenhang mit Fehlern in der Transformation (optional).

• stageThreshold – Die maximale Anzahl von Fehlern, die in der Transformation auftreten dürfen, bevor der Vorgang abgebrochen wird (optional). Der Standardwert ist „Null“.

• totalThreshold – Die maximale Anzahl von Fehlern, die insgesamt auftreten dürfen, bevor die Verarbeitung abgebrochen wird (optional). Der Standardwert ist „Null“.

apply(cls, *args, **kwargs)

Geerbt von GlueTransform apply.

name(cls)

Geerbt von GlueTransform Name.

describeArgs(cls)

Geerbt von GlueTransform describeArgs.

describeReturn(cls)

Geerbt von GlueTransform describeReturn.

describeTransform(cls)

Geerbt von GlueTransform describeTransform.

describeErrors(cls)

Geerbt von GlueTransform describeErrors.

describe(cls)

Geerbt von GlueTransform Beschreiben.