TRY_TO_FILE

Eine Version von TO_FILE, die NULL zurückgibt, anstatt einen Fehler zu melden.

Syntax

Verwenden Sie eine der folgenden Optionen:

TRY_TO_FILE( <stage_name>, <relative_path> )

TRY_TO_FILE( <file_url> )

TRY_TO_FILE( <metadata> )

Argumente

stage_name

Der Name des Stagingbereichs, in dem sich die Datei befindet, als Zeichenfolge im Format '@stage_name'.

relative_path

Der Pfad zu der Datei im durch stage_name als Zeichenfolge angegebenen Stagingbereich.

file_url

Ein gültiger Stagingbereich oder eine Bereichsdatei-URL als Zeichenfolge.

metadata

Ein OBJECT mit den erforderlichen FILE-Metadaten. Eine FILE muss die Felder CONTENT_TYPE, SIZE, ETAG und LAST_MODIFIED enthalten. Außerdem muss der Speicherort der Datei auf eine der folgenden Arten angegeben sein:

  • Sowohl STAGE als auch RELATIVE_PATH

  • STAGE_FILE_URL

  • SCOPED_FILE_URL

Rückgabewerte

Eine FILE oder NULL.

Nutzungshinweise

Gibt NULL zurück, wenn:

  • Die angegebene URL nicht gültig ist.

  • Die Datei befindet sich in einem Stagingbereich, für den der Benutzer keine Zugriffsberechtigung hat.

  • Die angegebenen Metadaten enthalten nicht die erforderlichen FILE-Felder.

Beispiele

Siehe TO_FILE.