Este artigo inclui etapas para criar e gerir instantâneos de armazém usando o portal Fabric, consultas T-SQL ou a API Fabric.
Pré-requisitos
- Um espaço de trabalho do Fabric com capacidade ativa ou em avaliação.
- Um armazém de tecidos.
- Verifique as permissões de usuário necessárias.
Criar
Vários snapshots podem ser criados para o mesmo armazém pai. Depois que os instantâneos do armazém são criados, eles aparecem como itens filhos do armazém pai na vista do espaço de trabalho.
Os instantâneos do armazém podem ser criados por meio do portal Fabric. Na faixa de opções, em Gestão, selecione Novo instantâneo de armazém.
Exemplo de solicitação JSON para criar um instantâneo de armazém por meio da API REST.
POST https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items
Authorization: Bearer <bearer token>
Content-Type: application/json
{
"type": "WarehouseSnapshot",
"displayName": "<snapshot item display name>",
"description": "<helpful description of snapshot item>",
"creationPayload": {
"parentWarehouseId": "<parent warehouse ID>",
"snapshotDateTime": "<YYYY-MM-DDTHH:SS:SSZ>" //Enter UTC time
}
}
Substitua <workspace ID> e <parent warehouse ID> pelos IDs de espaço de trabalho e de depósito do Fabric correspondentes. Para encontrar esses valores, visite seu armazém no portal Fabric.
-
<workspace ID>: Encontre o GUID do espaço de trabalho no URL após a /groups/ secção ou executando SELECT @@SERVERNAME em um armazém existente. Por exemplo, 11aaa111-a11a-1111-1aaa-aa111111aaa. Não inclua os / caracteres.
-
<parent warehouse ID>: Encontre o GUID do armazém no URL na secção /warehouses/, ou executando SELECT @@SERVERNAME em um armazém existente. Por exemplo, 11aaa111-a11a-1111-1aaa-aa111111aaa. Não inclua os / caracteres.
<bearer token>: Obtenha isso seguindo estas etapas:
- Abra o seu espaço de trabalho Microsoft Fabric num navegador (Microsoft Edge ou Google Chrome).
- Pressione F12 para abrir as Ferramentas de Desenvolvimento.
- Selecione a guia Console. Se necessário, selecione Visualização Rápida Expandida para revelar o prompt
> do console.
- Digite o comando
powerBIAccessToken e pressione Enter. Clique com o botão direito do mouse na cadeia de caracteres exclusiva grande retornada no console e selecione Copiar conteúdo da cadeia de caracteres.
- Cole-o no lugar de
<bearer token>.
Fornecer valores autoexplicativos para <snapshot item display name> e <helpful description of snapshot item>.
Forneça uma hora como referência para o instantâneo. O carimbo temporal pode ser definido para qualquer ponto dentro do período de retenção configurado. Se snapshotDateTime não for fornecido, o instantâneo usará a hora atual.
Para retornar as propriedades do instantâneo especificado:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
- Substitua
<workspace ID> e <warehouse snapshot ID> pelo ID do espaço de trabalho do Fabric correspondente e pelo ID de instantâneo do armazém. Para encontrar esses valores, visite o instantâneo do seu armazém no portal do Fabric.
-
<workspace ID>: Encontre o GUID do espaço de trabalho no URL após a /groups/ secção ou executando SELECT @@SERVERNAME em um armazém existente. Por exemplo, 11aaa111-a11a-1111-1aaa-aa111111aaa. Não inclua os / caracteres.
-
<warehouse snapshot ID>: Encontre o GUID do instantâneo do armazém na URL após a seção /warehousesnapshots/.
Consultar um instantâneo
Depois de criados, os instantâneos de armazém aparecem como subitens no espaço de trabalho.
Conecte-se ao snapshot como um depósito. Nas definições de instantâneo do seu armazém, selecione a página endpoint SQL para visualizar e copiar a cadeia de conexão SQL. Este é o nome do servidor para o snapshot do seu armazém, e tem o seguinte formato: <server-name>.datawarehouse.fabric.microsoft.com.
Os utilizadores com permissões apropriadas (Admin, Membro, Colaborador ou Visualizador) podem consultar um instantâneo como um armazém. Para mais informações, consulte Conectividade de armazém em Microsoft Fabric.
Exibir o timestamp da captura
Quando uma consulta T-SQL é executada, informações sobre a versão atual dos dados que estão sendo acessados são incluídas. Por exemplo, você pode ver o carimbo de data/hora nas Mensagens do editor de consultas do portal Fabric:
Para visualizar os instantâneos de um depósito e seus carimbos de data/hora atuais, execute a seguinte consulta T-SQL em sys.databases e utilize a propriedade estendida de TIMESTAMP para apresentar atributos:
SELECT snapshot_name = v.name
, source_warehouse_name = s.name
, snapshot_timestamp = DATABASEPROPERTYEX(v.name,'TIMESTAMP')
FROM sys.databases AS v
INNER JOIN sys.databases AS s ON v.source_database_id=s.database_id;
Atualizar carimbo de data/hora do instantâneo
Pode atualizar a marca temporal de um instantâneo de armazém existente a qualquer momento.
Você pode fazer isso com comandos T-SQL no contexto do armazém pai ou por meio do portal Fabric. Para mais informações, veja Atualizar data e hora do instantâneo.
No portal Fabric, selecione Capturar novo estado no menu de contexto e, depois, selecione um timestamp para o instantâneo. Pode selecionar Atual ou qualquer ponto dentro do período de retenção configurado.
A instrução SQL ALTER DATABASE usa a hora do sistema do armazém como o novo marco temporal no qual os dados do armazém de origem serão refletidos na captura instantânea.
Para atualizar o instantâneo para o estado atual do armazém, use CURRENT_TIMESTAMP.
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = CURRENT_TIMESTAMP;
O carimbo temporal também pode ser definido para qualquer ponto dentro do período de retenção configurado. O formato do TIMESTAMP argumento é YYYY-MM-DDTHH:MM:SS.SS. Por exemplo, para definir o carimbo de data/hora para 27 de abril de 2025 às 18:10 UTC:
ALTER DATABASE [<snapshot name>]
SET TIMESTAMP = '2025-04-27T18:10:00.00';
Os instantâneos do armazém também podem ser atualizados por meio do portal Fabric. Na barra de ferramentas, em Gestão, selecione Gerir instantâneo do armazém.
Note
Quando alterares o período de retenção configurável, se uma diminuição do período invalidar um ou mais snapshots existentes do armazém (porque o timestamp do snapshot fica fora da nova janela de retenção), a alteração do período de retenção é bloqueada. Para avançar, primeiro avance os snapshots afetados para um carimbo temporal mais recente ou elimine-os, e depois atualize o período de retenção.
Mudar o nome
Você pode renomear um instantâneo de item de armazém por meio da API REST e no portal Fabric.
Os instantâneos do armazém podem ser renomeados por meio do portal Fabric. Abra o instantâneo do seu armazém. Selecione o botão de configurações, forneça um novo Nome.
Exemplo de solicitação JSON para renomear um instantâneo de depósito por meio da API REST:
PATCH https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
Content-Type: application/json
{
"type": "WarehouseSnapshot",
"displayName": "<snapshot item new display name>",
"description": "<helpful description of snapshot item>",
"creationPayload": {
"parentWarehouseId": "<parent warehouse ID>",
"snapshotDateTime": "YYYY-MM-DDTHH:SS:SSZ" //Enter UTC time
}
}
Substitua <workspace ID>, <warehouse snapshot ID> e <parent Warehouse ID> pelos IDs correspondentes de espaço de trabalho e de depósito. Para encontrar esses valores, visite o instantâneo do seu armazém no portal do Fabric.
-
<workspace ID>: Encontre o GUID do espaço de trabalho no URL após a /groups/ secção ou executando SELECT @@SERVERNAME em um armazém existente. Por exemplo, 11aaa111-a11a-1111-1aaa-aa111111aaa. Não inclua os / caracteres.
-
<warehouse snapshot ID>: Encontre o GUID do instantâneo do armazém na URL após a seção /warehousesnapshots/.
-
<parent warehouse ID>: Encontre o GUID do armazém no URL na secção /warehouses/, ou executando SELECT @@SERVERNAME em um armazém existente. Por exemplo, 11aaa111-a11a-1111-1aaa-aa111111aaa. Não inclua os / caracteres.
<bearer token>: Obtenha isso seguindo estas etapas:
- Abra o seu espaço de trabalho Microsoft Fabric num navegador (Microsoft Edge ou Google Chrome).
- Pressione F12 para abrir as Ferramentas de Desenvolvimento.
- Selecione a guia Console. Se necessário, selecione Visualização Rápida Expandida para revelar o prompt
> do console.
- Digite o comando
powerBIAccessToken e pressione Enter. Clique com o botão direito do mouse na cadeia de caracteres exclusiva grande retornada no console e selecione Copiar conteúdo da cadeia de caracteres.
- Cole-o no lugar de
<bearer token>.
Fornecer valores autoexplicativos para <snapshot item new display name> e <helpful description of snapshot item>.
Forneça uma hora como referência para o instantâneo. O carimbo temporal pode ser definido para qualquer ponto dentro do período de retenção configurado. Se snapshotDateTime não for fornecido, o instantâneo usará a hora atual.
Suprimir
Você pode excluir um instantâneo de armazém no portal do Fabric ou com a API REST.
Os instantâneos do armazém podem ser excluídos por meio do portal do Fabric. Na lista de itens do espaço de trabalho, selecione o menu de contexto do item de instantâneo do armazém e selecione Eliminar.
Exemplo de solicitação de API REST para excluir um snapshot:
DELETE https://api.fabric.microsoft.com/v1/workspaces/<workspace ID>/items/<warehouse snapshot ID>
Authorization: Bearer <bearer token>
- Substitua
<workspace ID> e <warehouse snapshot ID> pelos IDs de espaço de trabalho e de depósito do Fabric correspondentes. Para encontrar esses valores, visite o instantâneo do seu armazém no portal do Fabric.
-
<workspace ID>: Encontre o GUID do espaço de trabalho no URL após a /groups/ secção ou executando SELECT @@SERVERNAME em um armazém existente. Por exemplo, 11aaa111-a11a-1111-1aaa-aa111111aaa. Não inclua os / caracteres.
-
<warehouse snapshot ID>: Encontre o GUID do instantâneo do armazém na URL após a seção /warehousesnapshots/.
-
<bearer token>: Obtenha isso seguindo estas etapas:
- Abra o seu espaço de trabalho Microsoft Fabric num navegador (Microsoft Edge ou Google Chrome).
- Pressione F12 para abrir as Ferramentas de Desenvolvimento.
- Selecione a guia Console. Se necessário, selecione Visualização Rápida Expandida para revelar o prompt
> do console.
- Digite o comando
powerBIAccessToken e pressione Enter. Clique com o botão direito do mouse na cadeia de caracteres exclusiva grande retornada no console e selecione Copiar conteúdo da cadeia de caracteres.
- Cole-o no lugar de
<bearer token>.
Conteúdo relacionado
