Configurar o espaço em disco do gateway

Este artigo se concentra nas definições de configuração que controlam o espaço em disco para usuários do gateway que ficam sem espaço em disco.

Dados de spool do gateway

O Power BI e o gateway de dados local criam arquivos de cache temporários ao se comunicarem entre o ambiente local e a nuvem em um processo chamado spool. Dependendo da quantidade de espaço em disco disponível para spool, é possível que ocorra um erro de "falta de espaço em disco" quando o espaço em disco está cheio devido ao spooler.

Observação

Recomendamos que você use uma SSD (unidade de estado sólido) como a unidade de armazenamento de spool para obter o desempenho ideal.

Quando o spool causar um erro de "falta de espaço em disco", use as etapas a seguir para alterar o local do spooler para um disco com mais capacidade.

  1. Navegue até C:\Program Files\On-premises data gateway.

  2. Faça uma cópia de backup do arquivo de configuração Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.

  3. Edite o arquivo de configuração Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config.

  4. Procure SpoolerDirectory.

    <setting name="SpoolerDirectory" serializeAs="String">
        <value>%LOCALAPPDATA%\Microsoft\On-premises data gateway\Spooler</value>
    </setting>
    

    A marca <value> especifica a localização do SpoolerDirectory.

  5. Modifique esse caminho para um local que contenha espaço em disco suficiente para suas necessidades de negócios.

  6. Após a modificação, salve o arquivo e reinicie o gateway de dados local.

Observação

Se você modificar o caminho, também precisará reiniciar o serviço de gateway de dados local.

Screenshot

Cache persistente do mecanismo de mashup

Se o spool foi mapeado para uma unidade diferente, mas você continuar recebendo erros de "falta de espaço em disco", o motivo poderá ser o cache persistente. Esse erro pode ser devido a consultas que não dobram (para obter mais informações sobre dobra de consulta, acesse Visão geral da dobragem de consultas). Ou o erro pode ser devido a consultas com desempenho insatisfatório (para obter mais informações de como otimizar o desempenho do gateway, acesse Monitorar e otimizar o desempenho do gateway de dados local).

Se a consulta não puder ser otimizada, você poderá mover o cache persistente para uma unidade de maior capacidade. O cache persistente (em oposição ao spooler) usa a unidade raiz e o caminho \temp do sistema operacional. Para evitar o erro "sem espaço em disco", você precisará liberar espaço na unidade raiz, expandir o tamanho da unidade raiz ou possivelmente remapear a pasta temporária para uma unidade com mais espaço.

Você pode alterar (ou definir) o valor da variável de ambiente TMP do Windows da conta de usuário que está sendo usada para executar o gateway para mover o cache persistente a uma unidade de maior capacidade. O caminho usado para diretórios de cache e temp é determinado por meio da função GetTempPath do Win32. Segundo a documentação do Win32, essa função usa o primeiro valor encontrado na seguinte lista:

  • O caminho especificado pela variável de ambiente TMP.
  • O caminho especificado pela variável de ambiente TEMP.
  • O caminho especificado pela variável de ambiente USERPROFILE.
  • O diretório do Windows.

Portanto, altere o TMP do usuário do gateway a fim de mover o cache persistente para outra unidade.

Observação

Para alterar as variáveis de ambiente no Windows, no menu Iniciar, selecione Pesquisar, insira Variáveis de Ambiente, selecione Editar as variáveis de ambiente do sistema e, em Propriedades do Sistema, selecione Variáveis de Ambiente.