Compartilhar via


Restaurar registros excluídos da tabela do Microsoft Dataverse (versão preliminar)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Como parte dos processos empresariais regulares com o Microsoft Dataverse, os usuários frequentemente excluem registros ou transações manual ou sistematicamente, planejadas ou acidentalmente, por meio de processos do sistema, seleção única, seleções múltiplas e exclusão em massa. A recuperação de dados excluídos é difícil e, geralmente, os registros nem sempre podem ser recuperados. Para resolver essa limitação, a lixeira está disponível para recuperar dados de registros de tabela da maioria dos tipos de cenários de exclusão dentro de um período configurável especificado.

Os desenvolvedores devem ler Restaurar registros excluídos com código (versão preliminar) para saber como interagir com esse recurso usando código.

Importante

  • Este é um recurso em versão preliminar.
  • Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.
  • Este recurso está sendo implementado atualmente e talvez ainda não esteja disponível em sua região.
  • Qualquer armazenamento usado pela lixeira não é contabilizado na capacidade de armazenamento da organização.
  • O recurso de lixeira não está disponível para ambientes de avaliação ou ambientes padrão do Dataverse for Teams.

Pré-requisitos

Para restaurar registros excluídos do Dataverse, ative a lixeira em seu ambiente.

Ativar a lixeira

  1. Entre no centro de administração do Power Platform como um administrador (administrador do Dynamics 365 ou administrador do Microsoft Power Platform).

  2. Selecione Ambientes e abra o ambiente que você deseja.

  3. Selecione Definições>Produto>Recursos.

  4. Role para baixo para ver as configurações da Lixeira.

    • Ative a configuração da Lixeira.
    • Especifique o intervalo de tempo para poder restaurar registros da tabela. Você pode restaurar registros da tabela por até 30 dias após a exclusão do registro.
  5. Selecione Salvar.

  6. Aguarde 30 minutos para que o sistema configure a lixeira.

    Observação

    Somente os registros excluídos após a ativação do recurso Lixeira podem ser restaurados.

Exibir e restaurar os registros excluídos no Power Apps

Exibir e agir sobre os registros excluídos na experiência do usuário do Power Apps só está disponível para Administradores do Sistema na fase de versão preliminar.

Centro de administração do Power Platform

Para restaurar registros excluídos do centro de administração:

  1. Entre no Centro de administração do Power Platform como um usuário com a função de segurança de administrador do sistema.
  2. Selecione Ambientes e abra o ambiente no qual você quer exibir e restaurar os registros excluídos.
  3. Vá para Configurações>Gerenciamento de dados>Exibir Registros Excluídos.
  4. Você pode exibir todos os registros excluídos de todas as tabelas.
  5. Selecione um ou mais registros que você deseja restaurar e, em seguida, selecione Restaurar na barra de comandos.
  6. Selecione OK para confirmar a ação de restauração.

Aplicativo de Configurações do Ambiente do Power Platform

Para restaurar registros excluídos do Aplicativo de Configurações do Ambiente do Power Platform:

  1. Entre no ambiente do Power Platform como usuário com o direito de acesso de administrador do sistema.
  2. Selecione o aplicativo Configuração do Ambiente do Power Platform ou selecione Configurações>Configurações Avançadas.
  3. Vá para Sistema>Gerenciamento de dados>Exibir Registros Excluídos.
  4. Você pode exibir todos os registros excluídos de todas as tabelas.
  5. Selecione um ou mais registros a serem restaurados e selecione Restaurar na barra de comandos.
  6. Selecione OK para confirmar a restauração.

Desativar a Lixeira de uma tabela

Para desativar a lixeira de uma tabela:

  1. Entre no Power Apps como usuário com o direito de acesso de administrador do sistema e verifique se o ambiente correto está selecionado.
  2. Selecione Tabelas e abra a tabela desejada. Se as Tabelas não estiver no painel lateral, selecione …Mais e selecione-as.
  3. Selecione Propriedades, expanda Opções avançadas e desmarque Habilitar lixeira. Se a caixa de seleção estiver desabilitada, a tabela não poderá ser habilitada para lixeira ou o recurso não estará ativado para o ambiente.
  4. O Intervalo de Configuração representa o número de dias em que os dados são persistidos na Lixeira da tabela. A definição desse valor como -1 usa o valor padrão de ambiente para essa tabela.

Captura de tela da opção Desabilitar Lixeira de uma tabela.

Limitações

A lixeira só tem suporte para operações de exclusão

A lixeira só tem suporte para operações de exclusão, não para atualizações.

A operação de restauração é para registros

A operação de restauração é apenas para registros. Ele não oferece suporte à recuperação de organizações ou tabelas.

Alguns registros não são restaurados

Algumas organizações adicionam lógica de negócios personalizada que exclui registros relacionados a um registro que foi excluído. Para restaurar registros relacionados excluídos pela lógica de negócios personalizada, você precisa aplicar a lógica oposta na Restore operação para recuperar os registros quando você restaurar o registro original que foi excluído.

Os registros excluídos por meio do processo de comportamento em cascata do relacionamento da tabela podem ser restaurados. Para obter mais informações sobre comportamento em cascata, consulte Configurar comportamento em cascata de relacionamento de tabela.

Os registros excluídos não são mostrados após a ativação da lixeira

Os registros excluídos talvez não apareçam mesmo quando o recurso de lixeira está ativado. Verifique se o trabalho do sistema Habilitar Lixeira para Organização está ativado. Vá para o centro de administração do Power Platform, selecione o ambiente onde esse problema está acontecendo e selecione Configurações>Auditoria e logs>Trabalhos do sistema. Na página Trabalhos do sistema, procure por Habilitar Lixeira. Confirme se a Razão do Status é Com Êxito.

Se a Razão do Status não for Bem-sucedida e tiver passado pelo menos 30 minutos desde a ativação do recurso, ou apesar do estado de êxito parecer correto, e você não estiver vendo a opção Restaurar para registros excluídos, entre em contato com um Representante de suporte da Microsoft e crie uma solicitação de suporte.

Os registros excluídos só aparecerão depois que a lixeira estiver ativada e só aparecerão para registros excluídos após a ativação do recurso. Não é possível restaurar registros excluídos antes que o recurso de lixeira tenha sido habilitado.

Registros excluídos por meio de comportamentos em cascata não estão presentes na exibição Registros Excluídos

Registros que foram excluídos por meio de comportamentos em cascata automatizados não podem ser restaurados de forma independente. Esses registros precisam ser restaurados na ordem em que foram excluídos. O registro original que foi excluído deve ser restaurado antes de quaisquer registros relacionados que foram excluídos por meio de comportamentos em cascata automatizados.

Para obter mais informações sobre comportamento em cascata, consulte Configurar comportamento em cascata de relacionamento de tabela.

Não há suporte para tabelas

Quando a lixeira estiver disponível para o público em geral, ela será habilitada para a maioria das tabelas.

Algumas tabelas não oferecem suporte à lixeira. Essas tabelas incluem:

Durante a visualização, algumas tabelas com um grande número de colunas não têm suporte no momento. Atualmente, o número máximo de colunas é 400. Esse valor pode aumentar ou diminuir conforme determinamos o limite correto.

Os desenvolvedores podem executar uma consulta que retorna quais tabelas estão habilitadas para a lixeira em seu ambiente.

Tabelas sem suporte atual para a Lixeira

Essas tabelas são retornadas da consulta para detectar quais tabelas não têm a lixeira habilitada para um ambiente não personalizado do Dataverse a partir de agosto de 2024.

Seu ambiente pode ter resultados diferentes. Talvez não haja suporte para tabelas personalizadas pela adição de um grande número de colunas.

aaduser
aicopilot
aiplugin
aipluginconversationstartermapping
aipluginexternalschemaproperty
aipluginoperation
aipluginoperationresponsetemplate
annualfiscalcalendar
appaction_appactionrule_classicrules
appactionrule
appconfig
application
applicationuser
applicationuserrole
appmodulecomponent
appnotification
asyncoperation
attributeimageconfig
backgroundoperation
bot_botcomponent
bot_environmentvariabledefinition
botcomponent_aipluginoperation
botcomponent_connectionreference
botcomponent_environmentvariabledefinition
botcomponent_workflow
bulkdeletefailure
businessunit
callbackregistration
card
cardstateitem
catalogassignment
columnmapping
componentversion
componentversionnrddatasource
connectionreference
connectionroleassociation
copilotexamplequestion
copilotsynonyms
customapi
customapiresponseproperty
customcontroldefaultconfig
datalakefolder
datalakeworkspace
dataprocessingconfiguration
desktopflowbinary
displaystring
duplicaterulecondition
dvfilesearchattribute
dvtablesearch
dvtablesearchentity
entity
entitydataprovider
entityindex
entityrecordfilter
environmentvariabledefinition
eventexpanderbreadcrumb
expiredprocess
fabricaiskill
federatedknowledgeconfiguration
fieldpermission
fixedmonthlyfiscalcalendar
flowlog
flowmachinegroup
flowmachineimageversion
flowrun
goal
importentitymapping
importjob
importmap
interactionforemail
kbarticletemplate
lookupmapping
mainfewshot
managedproperty
metadataforarchival
mobileofflineprofileitem
mobileofflineprofileitemfilter
msdyn_aiconfiguration
msdyn_aitemplate
msdyn_componentlayer
msdyn_connectordatasource
msdyn_dataflow_datalakefolder
msdyn_dataflowtemplate
msdyn_dmsrequest
msdyn_entitylinkchatconfiguration
msdyn_helppage
msdyn_knowledgeassetconfiguration
msdyn_knowledgesearchfilter
msdyn_modulerundetail
msdyn_odatav4ds
msdyn_pmbusinessruleautomationconfig
msdyn_pmcalendarversion
msdyn_pmprocessextendedmetadataversion
msdyn_pmprocessusersettings
msdyn_pmrecording
msdyn_pmview
msdyn_salesforcestructuredqnaconfig
msdyn_slakpi
msdyn_solutioncomponentcountsummary
msdyn_solutioncomponentsummary
msdyn_solutionhistorydatasource
msdyn_tour
mspp_adplacement
mspp_columnpermissionprofile
mspp_entityform
mspp_entitylist
mspp_pagetemplate
mspp_powerpagescoreentityds
mspp_publishingstatetransitionrule
mspp_shortcut
mspp_sitesetting
mspp_webform
mspp_webformstep
mspp_weblinkset
mspp_webpageaccesscontrolrule
mspp_website
mspp_websitelanguage
navigationsetting
nlsqregistration
ownermapping
pluginassembly
plugintracelog
position
powerbimashupparameter
powerfxrule
powerpagecomponent_powerpagecomponent
powerpagesite_dvfilesearch
powerpageslog
principalentitymap
privilegesremovalsetting
processstage
publisher
quarterlyfiscalcalendar
queuemembership
recordfilter
recyclebinconfig
relationshipattribute
reportcategory
retaineddataexcel
ribbonmetadatatoprocess
roleeditorlayout
roletemplate
runtimedependency
savedqueryvisualization
sdkmessagefilter
sdkmessageprocessingstepimage
searchtelemetry
serviceendpoint
serviceplanappmodules
serviceplanmapping
sharepointsite
sitemap
slaitem
solution
solutioncomponentattributeconfiguration
solutioncomponentconfiguration
solutionhistorydata
subscriptionsyncentryoffline
synapselinkprofile
synapselinkschedule
systemform
systemuserauthorizationchangetracker
systemuserroles
teamprofiles
teamtemplate
tracelog
transformationparametermapping
userform
userquery
virtualentitymetadata
webwizard
workflowbinary
workflowlog
workqueueitem

activityfileattachment
aicopilot_aiplugin
aipluginconversationstarter
aipluginexternalschema
aiplugininstance
aipluginoperationparameter
aiplugintitle
appaction
appactionmigration
appactionrule_webresource_scripts
appconfiginstance
applicationroles
applicationuserprofile
appmodule
appmoduleroles
appointment
attribute
attributemaskingrule
bot
bot_botcomponentcollection
botcomponent
botcomponent_botcomponent
botcomponent_dvtablesearch
botcomponent_msdyn_aimodel
botcomponentcollection
bulkdeleteoperation
calendar
canvasapp
cardentityconnections
catalog
channelaccessprofileentityaccesslevel
complexcontrol
componentversiondatasource
connectioninstance
connectionrole
connector
copilotglossaryterm
credential
customapirequestparameter
customcontrol
customcontrolresource
datalakefolderpermission
datalakeworkspacepermission
dependency
desktopflowmodule
duplicaterule
dvfilesearch
dvfilesearchentity
dvtablesearchattribute
elasticfileattachment
entityanalyticsconfig
entityimageconfig
entitykey
entityrelationship
environmentvariablevalue
exchangesyncidmapping
exportedexcel
featurecontrolsetting
federatedknowledgeentityconfiguration
fieldsecurityprofile
flowcredentialapplication
flowmachine
flowmachineimage
flowmachinenetwork
fxexpression
import
importfile
importlog
indexattributes
invaliddependency
keyvaultreference
mailmergetemplate
managedidentity
maskingrule
mobileofflineprofile
mobileofflineprofileitemassociation
monthlyfiscalcalendar
msdyn_aimodel
msdyn_appinsightsmetadata
msdyn_componentlayerdatasource
msdyn_dataflow
msdyn_dataflowconnectionreference
msdyn_datalakeds
msdyn_dmsrequeststatus
msdyn_formmapping
msdyn_insightsstorevirtualentity
msdyn_knowledgemanagementsetting
msdyn_mobileapp
msdyn_nonrelationalds
msdyn_pmanalysishistory
msdyn_pmcalendar
msdyn_pminferredtask
msdyn_pmprocesstemplate
msdyn_pmprocessversion
msdyn_pmtemplate
msdyn_salesforcestructuredobject
msdyn_schedule
msdyn_solutioncomponentcountdatasource
msdyn_solutioncomponentdatasource
msdyn_solutionhistory
msdyn_timelinepin
msdyn_workflowactionstatus
mspp_columnpermission
mspp_contentsnippet
mspp_entityformmetadata
mspp_entitypermission
mspp_pollplacement
mspp_publishingstate
mspp_redirect
mspp_sitemarker
mspp_webfile
mspp_webformmetadata
mspp_weblink
mspp_webpage
mspp_webrole
mspp_websiteaccess
mspp_webtemplate
newprocess
optionset
picklistmapping
pluginpackage
plugintype
powerbidataset
powerbireport
powerpagecomponent
powerpagesite
powerpagesitelanguage
principalentitybusinessunitmap
privilege
processsession
processtrigger
publisheraddress
queue
recentlyused
recurringappointmentmaster
relationship
report
reportparameter
retentionconfig
role
roleprivileges
roletemplateprivileges
savedquery
sdkmessage
sdkmessageprocessingstep
searchresultscache
semiannualfiscalcalendar
serviceplan
serviceplancustomcontrol
sharedlinksetting
similarityrule
sla
slakpiinstance
solutioncomponent
solutioncomponentbatchconfiguration
solutioncomponentrelationshipconfiguration
subscriptionstatisticsoffline
synapsedatabase
synapselinkprofileentity
syncerror
systemuser
systemuserprofiles
teammobileofflineprofilemembership
teamroles
template
transformationmapping
translationprocess
usermobileofflineprofilemembership
userqueryvisualization
webresource
workflow
workflowcardconnections
workqueue

Restaurar registros excluídos com código (versão preliminar)