sp_pdw_log_user_data_mask (Azure Synapse Analytics)

Van toepassing op:Azure Synapse Analytics

Gebruik sp_pdw_log_user_data_masking om user data masking in Azure Synapse Analytics activity logs in te schakelen. User data masking beïnvloedt de statements op alle databases van het apparaat.

Important

De Azure Synapse Analytics activity logs affected by sp_pdw_log_user_data_masking is bepaalde Azure Synapse Analytics activity logs. sp_pdw_log_user_data_maskingbeïnvloedt geen databasetransactielogs of SQL Server-foutlogboeken.

Syntax

Syntax for Azure Synapse Analytics.

sp_pdw_log_user_data_masking [ [ @masking_mode = ] value ]
[ ; ]

Note

Deze syntaxis wordt niet ondersteund door een serverloze SQL-pool in Azure Synapse Analytics.

Achtergrond

In de standaardconfiguratie bevatten Azure Synapse Analytics activiteitslogboeken volledige Transact-SQL statements, en kunnen in sommige gevallen gebruikersgegevens bevatten die zijn opgenomen in bewerkingen zoals INSERT, UPDATE, en SELECT instructies. Als er een probleem is op het apparaat, maakt dit de analyse van de omstandigheden die het probleem veroorzaakten mogelijk zonder dat het probleem hoeft te worden gereproduceerd. Om te voorkomen dat gebruikersgegevens worden geschreven naar Azure Synapse Analytics-activiteitenlogs, kunnen klanten ervoor kiezen om de gebruikersgegevensmaskering in te schakelen met behulp van deze opgeslagen procedure. De statements worden nog steeds geschreven in Azure Synapse Analytics activiteitenlogs, maar alle literals in statements die mogelijk gebruikersgegevens bevatten worden gemaskeerd; vervangen door enkele vooraf gedefinieerde constante waarden.

Wanneer transparante gegevensversleuteling op het apparaat is ingeschakeld, wordt het maskeren van de gebruikersgegevens in de Azure Synapse Analytics-activiteitenlogs automatisch ingeschakeld.

Arguments

[ @masking_mode = ] masking_mode

Bepaalt of transparante data-encryptie-log gebruikersmaskering is ingeschakeld. masking_mode is int, en kan een van de volgende waarden zijn:

Value Description
0 Uitgeschakeld, gebruikersgegevens verschijnen in de Azure Synapse Analytics activiteitenlogs.
1 Ingeschakeld verschijnen user data statements in de Azure Synapse Analytics activiteitenlogs, maar de gebruikersgegevens zijn gemaskeerd.
2 Statements met gebruikersgegevens worden niet geschreven naar de Azure Synapse Analytics activiteitenlogs.

Uitvoeren sp_pdw_log_user_data_masking zonder parameters geeft de huidige status van transparante data-encryptie (TDE) log log gebruikersgegevensmaskering op het apparaat terug als een scalair resultaatset.

Remarks

Gebruikersgegevensmaskering in Azure Synapse Analytics activiteitenlogs maakt het mogelijk om literals te vervangen door vooraf gedefinieerde constante waarden in SELECT Data Manipulation Language (DML)-instructies, omdat deze gebruikersgegevens kunnen bevatten. Het instellen van masking_mode op 1 maskeert geen metadata, zoals kolomnamen of tabelnamen. Door masking_mode op 2 te zetten, worden statements met metadata verwijderd, zoals kolomnamen of tabelnamen.

Gebruikersgegevensmaskering in Azure Synapse Analytics activiteitenlogs wordt op de volgende manier geïmplementeerd:

  • TDE- en gebruikersdata-maskering in Azure Synapse Analytics activiteitslogs zijn standaard uitgeschakeld. De statements worden niet automatisch gemaskeerd als database-encryptie niet op het apparaat is ingeschakeld.

  • Het inschakelen van TDE op het apparaat schakelt automatisch de gebruikersdata-maskering in de Azure Synapse Analytics activiteitenlogs in.

  • Het uitschakelen van TDE beïnvloedt geen user data masking in Azure Synapse Analytics activity logs.

  • Je kunt expliciet user data masking inschakelen in Azure Synapse Analytics activiteitenlogs door de sp_pdw_log_user_data_masking procedure te gebruiken.

Permissions

Vereist lidmaatschap van de sysadmin-vaste databaserol, of CONTROL SERVER een toestemming.

Examples

Het volgende voorbeeld maakt TDE-loggebruikersgegevensmaskering op het apparaat mogelijk.

EXECUTE sp_pdw_log_user_data_masking 1;