Kategorien:

Systemfunktionen

SYSTEM$GET_TAG_ON_CURRENT_TABLE

Gibt den Tag-Zeichenfolgenwert zurück, der der Tabelle auf Grundlage des angegebenen Tags zugewiesen wurde, oder NULL, wenn der angegebenen Tabelle kein Tag zugewiesen ist.

Verwenden Sie diese Funktion in den Bedingungen von Maskierungsrichtlinien oder Zeilenzugriffsrichtlinien.

Syntax

SYSTEM$GET_TAG_ON_CURRENT_TABLE( '<tag_name>' )
Copy

Argumente

'tag_name'

Bezeichner für das Tag als Zeichenfolge.

Wenn das Tag zum Beispiel cost_center heißt, verwenden Sie 'cost_center' als Argument.

Nutzungshinweise

  • Derzeit kann diese Funktion nur in Bedingungen einer Maskierungsrichtlinie oder Zeilenzugriffsrichtlinie verwendet werden, um den für eine Tabelle festgelegten Tag-Zeichenfolgenwert dynamisch auszuwerten.

    Snowflake gibt einen Fehler zurück, wenn die Funktion in einer SELECT Abfrage, Ansicht, materialisierten Ansicht oder einer benutzerdefinierten Funktion (UDF) verwendet wird.

  • Beachten Sie, dass diese Funktion für alle tabellenähnlichen Objekte (z. B. Ansichten) gilt.

  • Das Tag muss beim Aufrufen dieser Systemfunktion vorhanden sein. Andernfalls gibt Snowflake die folgende Fehlermeldung zurück:

    Tag '<tag_name>' does not exist or not authorized.
    
    Copy

Beispiele

Ein kontextbezogenes Beispiel für die Verwendung dieser Funktion finden Sie unter Beispiel 3: Schutz einer Tabelle basierend auf dem Tag-Zeichenfolgenwert.