Verwalten von Verhaltensänderungen¶
In diesem Dokument wird erklärt, wie Sie überprüfen können, ob ein bestimmtes Verhaltensänderungs-Bundle in Ihrem Konto aktiviert ist und wie Sie dieses aktivieren oder deaktivieren können.
Unter diesem Thema:
Übersicht¶
Snowflake implementiert Verhaltensänderungen monatlich in Bundles, die in den regelmäßig veröffentlichten Releases enthalten sind. Während der Testphase und der Opt-out-Phase jedes Verhaltensänderungs-Bundles können Sie das Bundle in Ihrem Konto aktivieren oder deaktivieren. In diesem Dokument wird erklärt, wie Sie überprüfen können, ob ein bestimmtes Bundle in Ihrem Konto aktiviert ist und wie Sie es aktivieren oder deaktivieren können.
In diesem Dokument ist bundle_name
der Name des Verhaltensänderungs-Bundles im Format YYYY_NN
, der im Dokument Änderungsprotokoll für Verhaltensänderungen zu finden ist.
Bemerkung
Die jeweiligen Verhaltensänderungen in einem Bundle können nicht einzeln aktiviert/deaktiviert werden. Um eine Verhaltensänderung zu aktivieren oder zu deaktivieren, müssen Sie das Bundle, das die Änderung enthält, aktivieren/deaktivieren.
Überprüfen des Status eines Verhaltensänderungs-Bundles für Ihr Konto¶
Um zu prüfen, ob ein bestimmtes Verhaltensänderungs-Bundle in Ihrem Konto aktiviert ist, verwenden Sie die Funktion SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS mit bundle_name
als Argument:
SELECT SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS('2021_02'); +-------------------------------------------------+ | SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS('2021_02') | |-------------------------------------------------| | DISABLED | +-------------------------------------------------+
Aktivieren eines Verhaltensänderungs-Bundles in Ihrem Konto¶
Um eine bestimmte Verhaltensänderung in Ihrem Konto zu aktivieren, verwenden Sie die Funktion SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE, und geben Sie dabei in bundle_name
den Namen des Bundles an, das die Änderung enthält:
SELECT SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2021_02'); +-------------------------------------------------+ | SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2021_02') | |-------------------------------------------------| | ENABLED | +-------------------------------------------------+
Deaktivieren eines Verhaltensänderungs-Bundles in Ihrem Konto¶
Um eine bestimmte Verhaltensänderung in Ihrem Konto zu deaktivieren, verwenden Sie die Funktion SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE, und geben Sie dabei in bundle_name
den Namen des Bundles an, das die Änderung enthält:
SELECT SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE('2021_02'); +-------------------------------------------------+ | SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE('2021_02')| |-------------------------------------------------| | DISABLED | +-------------------------------------------------+
Abmildern der Aktualisierung der Rückgabewerte von Maskierungsrichtlinien¶
In einem zukünftigen Verhaltensänderungs-Release-Bundle plant Snowflake die Rückgabe von Werten für Länge, Genauigkeit und Skalierung in Bedingungen von Maskierungsrichtlinien (zusammen: „Aktualisierung der Rückgabewerte“). Wenn diese Aktualisierung der Rückgabewerte vorgenommen wird, schlägt eine Abfrage auf eine Spalte, die durch eine Maskierungsrichtlinie geschützt ist, fehl, wenn die folgenden Bedingungen erfüllt sind:
Das Bundle ist aktiviert.
Die Maskierungsrichtlinienbedingungen geben einen Wert zurück, dessen Länge, Skalierung oder Genauigkeit größer ist als die Länge, Skalierung oder Genauigkeit der Spalte, der die Maskierungsrichtlinie zugewiesen ist. Beispiel:
Richtlinie erstellen:
CREATE MASKING POLICY MP AS (s string) RETURNS STRING -> 'abcdef';
Richtlinie zuweisen:
CREATE TABLE t(col1 string(2)); ALTER TABLE t MODIFY COLUMN col1 SET MASKING POLICY mp;
Spalte abfragen (schlägt fehl):
SELECT * FROM t;
Um die Auswirkungen dieser Änderung zu ermitteln und genügend Zeit für die Aktualisierung der Bedingungen für die Maskierungsrichtlinie zum Schutz der Daten zu haben, fragen Sie die Ansicht SNOWFLAKE.BCR_ROLLOUT.BCR_2022_07_DDM_ROLLOUT ab, um zu verstehen, wie sich die zukünftige Aktualisierung der Rückgabewerte auf Ihr Konto auswirken.
Die Ansicht „BCR_2022_07_DDM_ROLLOUT“ ist temporär. Snowflake wird die Ansicht entfernen, wenn die Aktualisierung der Rückgabewerte in einem zukünftigen Verhaltensänderungs-Bundle allgemein verfügbar wird. Ab diesem Zeitpunkt wird es nicht mehr möglich sein, die Ansicht abzufragen, um die betroffenen Spalten und Richtlinien zu bestimmen oder um zu verhindern, dass die Spaltenabfrage oder die Zuweisungsoperation von Maskierungsrichtlinien aufgrund der Aktualisierung der Rückgabewerte fehlschlägt.
Maskierungsrichtlinie und Spaltenzuordnungen identifizieren¶
Gehen Sie wie folgt vor, um die Ansicht abzufragen und die anstehenden Änderungen der Rückgabewerte abzumildern:
Fragen Sie die Ansicht SNOWFLAKE.BCR_ROLLOUT.BCR_2022_07_DDM_ROLLOUT ab. Beispiel:
USE ROLE ACCOUNTADMIN; SELECT * FROM SNOWFLAKE.BCR_ROLLOUT.BCR_2022_07_DDM_ROLLOUT;
Werten Sie die Spalte REASON (siehe Abschnitt Referenz zur Ansicht „BCR_2022_07_DDM_ROLLOUT“) aus, um festzustellen, welche Aktualisierung an den Bedingungen der Maskierungsrichtlinie vorgenommen werden muss.
Aktualisieren Sie die Maskierungsrichtlinienbedingungen mit einer ALTER MASKING POLICY-Anweisung, um sicherzustellen, dass die Spaltendaten geschützt bleiben und dass die Richtlinienzuweisungsoperationen oder Abfragen geschützter Spalten nicht fehlschlagen.
Testen Sie die neuen Richtlinienbedingungen, indem Sie die Tabellenspalten abfragen, denen die Maskierungsrichtlinien zugewiesen sind.
Referenz zur Ansicht „BCR_2022_07_DDM_ROLLOUT“¶
In der Ansicht „BCR_2022_07_DDM_ROLLOUT“ (im Schema SNOWFLAKE.BCR_ROLLOUT) sind Informationen ab dem 15. Juli 2022 erfasst. Sie enthält die folgenden Spalten:
Spalte |
Datentyp |
Beschreibung |
---|---|---|
POLICY_NAME |
TEXT |
Der Name der Richtlinie. |
POLICY_ID |
NUMBER |
Interner/vom System generierter Bezeichner für die Richtlinie. |
POLICY_SCHEMA |
TEXT |
Das übergeordnete Schema der Richtlinie. |
POLICY_DATABASE |
TEXT |
Die übergeordnete Datenbank der Richtlinie. |
POLICY_BODY |
TEXT |
Die Bedingungen der Richtlinie zur Maskierung oder Demaskierung der Spaltendaten. |
COLUMN_NAME |
TEXT |
Der Name der Spalte, die die Richtlinie enthält. |
TABLE_NAME |
TEXT |
Der Name der Tabelle. |
TABLE_ID |
NUMBER |
Interner/systemgenerierter Bezeichner für die Tabelle. |
TABLE_SCHEMA |
TEXT |
Das übergeordnete Schema der Richtlinie. |
TABLE_DATABASE |
TEXT |
Die übergeordnete Datenbank der Richtlinie. |
REASON |
TEXT |
Möglicher Grund für das Zuordnungsproblem. |
Die Spalte REASON kann einen der folgenden Werte haben, die in der folgenden Tabelle in der Spalte REASON_MESSAGE angegeben sind. Die zusätzlichen Spalten in der nachstehenden Tabelle sollen Administratoren bei der Entscheidung helfen, wie die Spalte REASON zu interpretieren ist und wie die Bedingungen der Maskierungsrichtlinie zu aktualisieren sind:
Meldung mit dem Grund |
Ursache |
Aktion |
---|---|---|
POLICY_ASSOCIATION_ON_NOT_NULL_COLUMN |
Einer NOT NULL-Spalte ist eine Maskierungsrichtlinie zugewiesen. |
Stellen Sie sicher, dass keine der Maskierungsrichtlinienbedingungen in den Richtlinienbedingungen einen NULL-Wert zurückgibt. |
LENGTH_MISMATCH |
Eine Maskierungsrichtlinie, die einer Spalte zugewiesen ist, deren Datentyp VARCHAR oder BINARY ist, gibt Daten zurück, deren Länge größer ist als die Länge der Spalte. |
Ändern Sie die Maskierungsrichtlinienbedingungen, um sicherzustellen, dass die Länge des Rückgabewerts kleiner oder gleich der Länge der Spalte ist. |
PRECISION_MISMATCH |
Eine Maskierungsrichtlinie, die einer Spalte zugewiesen ist, deren Datentyp NUMBER ist, gibt Daten zurück, deren Genauigkeit größer ist als die Genauigkeit der Spalte. |
Ändern Sie die Richtlinienbedingungen, um sicherzustellen, dass die Genauigkeit des Rückgabewerts kleiner oder gleich der Genauigkeit der Spalte ist. |
SCALE_MISMATCH |
Eine Richtlinie, die einer Spalte zugewiesen ist, deren Datentyp NUMBER oder TIMESTAMP ist, gibt Daten zurück, deren Skalierung größer ist als die Skalierung der Spalte. |
Ändern Sie die Richtlinienbedingungen, um sicherzustellen, dass die Skalierung des Rückgabewerts kleiner oder gleich der Skalierung der Spalte ist. |
Unknown mismatch. Manual investigation recommended. |
Die Maskierungsrichtlinie gibt einen NULL-Wert zurück, oder die Maskierungsrichtlinienbedingungen enthalten eine Unterabfrage. |
Ändern Sie die Richtlinie so, dass der Rückgabewert kleiner oder gleich der Länge, Genauigkeit oder Skalierung der Spalte ist. |