Compartilhar via

Configurar definições de cache para uma aplicação Web no SharePoint Server

  • Artigo

APLICA-SE A:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint no Microsoft 365

Este artigo descreve como configurar a cache de BLOB baseada em disco, os perfis de cache de saída de página e a cache de objetos para uma aplicação Web no SharePoint Server.

Você habilita e configura o cache BLOB, faz as alterações de configuração nos perfis de cache de saída de página e no cache de objetos no arquivo Web.config no aplicativo Web ao qual deseja aplicar essas alterações. As alterações feitas no arquivo Web.config serão aplicadas a todos os conjuntos de sites no aplicativo Web.

O SharePoint Server inclui monitores de desempenho de cache que lhe permitem verificar se as definições da cache do farm estão corretas e que a colocação em cache está em execução no desempenho máximo. Para obter mais informações, veja Monitorizar o desempenho da cache no SharePoint Server 2016.

Observação

Configurar os perfis de cache de saída de página e o cache de objetos no nível do aplicativo Web irá substituir todas as configurações que tenham sido feitas pelos administradores do site no nível do conjunto de sites ou abaixo.

Dica

Pode haver ocasiões em que o cache BLOB fica fora de sincronia com o conteúdo. Por exemplo, após você restaurar um banco de dados de conteúdo, o cache BLOB ficará fora de sincroniza com o conteúdo. Para corrigir essa situação, você deve liberar o cache BLOB. Para obter mais informações, veja Esvaziar a cache de BLOB no SharePoint Server.

Para obter mais informações, veja Operações de definições de cache no SharePoint Server.

Definir as configurações de cache BLOB

Por padrão, o cache BLOB baseado em disco está desabilitado e deve ser habilitado no servidor Web front-end caso deseje usá-lo. Use o procedimento a seguir para definir as configurações de cache baseadas em disco para um aplicativo Web.

Importante

Antes de fazer mudanças no arquivo web.config, faça uma cópia dele usando um nome diferente (por exemplo web.config1), para que se um erro for inserido no arquivo, você possa restaurar a versão original.

Para definir as configurações de cache BLOB

  1. Verifique se você tem as seguintes credenciais administrativas: você deve ser um membro do grupo Administradores no computador local para definir as configurações de cache BLOB.

  2. Abra o Gerenciador de Servidor, clique em Ferramentas e, em seguida, em Gerenciador dos Serviços de Informações da Internet (IIS).

  3. No Gestor de Serviços de Informação Internet (IIS), no painel Ligações , expanda o nome do servidor que contém a aplicação Web e, em seguida, expanda Sites para ver a aplicação Web ou as aplicações que foram criadas.

  4. Clique com o botão direito no nome do aplicativo Web para o qual você deseja configurar o cache baseado em disco e clique em Explorar. O Windows Explorer abre com os diretórios do aplicativo Web escolhido listados.

  5. Na caixa de diálogo Abrir Com , clique em Bloco de Notas e, em seguida, clique em OK.

  6. No ficheiro web.config Bloco de Notas, localize a seguinte linha: <BlobCache location="C:\BlobCache\14" path="\.(gif|jpg|jpeg|jpe|jfif|bmp|dib|tif|tiff|themedbmp|themedcss|themedgif|themedjpg|themedpng|ico|png|wdp|hdp|css|js|asf|avi|flv|m4v|mov|mp3|mp4|mpeg|mpg|rm|rmvb|wma|wmv|ogg|ogv|oga|webm|xap)$" maxSize="10" enabled="false" />

    O tamanho máximo predefinido de uma imagem ao utilizar Representações de Imagens é de 40 mega pixels. Se quiser modificar este valor, terá de adicionar o parâmetro imageRenditionMaxSourcePixels. Por exemplo: <BlobCache location="C:\BlobCache\14" path="\.(gif|jpg|jpeg|jpe|jfif|bmp|dib|tif|tiff|themedbmp|themedcss|themedgif|themedjpg|themedpng|ico|png|wdp|hdp|css|js|asf|avi|flv|m4v|mov|mp3|mp4|mpeg|mpg|rm|rmvb|wma|wmv|ogg|ogv|oga|webm|xap)$" maxSize="10" imageRenditionMaxSourcePixels="100000000" enabled="true" /> Isto definirá o tamanho máximo da imagem para que as Representações de Imagens funcionem a cerca de 100 mega pixels.

  7. Nesta linha, altere o location atributo para especificar um diretório que tenha espaço suficiente para acomodar o tamanho da cache.

    Observação

    É altamente recomendável que você especifique um diretório que não esteja na mesma unidade em que os arquivos de troca do sistema operacional do servidor ou os arquivos de log do servidor são armazenados.

  8. Para adicionar ou remover tipos de ficheiro da lista de tipos de ficheiro a colocar em cache, para o path atributo, modifique a expressão regular para incluir ou remover a extensão de ficheiro adequada. Se você adicionar extensões de arquivo, tenha certeza de separar cada tipo de arquivo com uma barra vertical (|), conforme mostrado nesta linha de código.

  9. Para alterar o tamanho da cache, escreva um novo número para maxSize. O tamanho é expresso em gigabytes (GB) e 10 GB é o padrão.

    Importante

    Recomenda-se que você não defina o tamanho do cache para um valor menor que 10 GB. Ao definir o tamanho do cache, tenha certeza de especificar um número grande o suficiente para fornecer um buffer pelo menos 20% maior do que o tamanho estimado do conteúdo que será armazenado no cache.

  10. Para ativar a cache de BLOB, altere o enabled atributo de "false" para "true".

  11. Salve o arquivo do Bloco de Notas e feche-o.

Cuidado

Quando guarda uma alteração no ficheiro de web.config, a aplicação Web nos Serviços de Informação Internet (IIS) 7.0 recicla automaticamente. Esta reciclagem pode causar uma breve interrupção no serviço para os sites contidos em tal aplicativo Web e os usuários podem perder o estado da sessão. Para obter informações sobre a reciclagem de aplicações Web no IIS 7.0, veja Reciclagem de Processos do IIS.

Definir as configurações de perfil de cache

As configurações de perfil de cache podem ser configuradas na interface do usuário no nível do conjunto de sites por um administrador de conjunto de sites, assim como no nível do aplicativo Web por um administrador no servidor Web front-end. O cache de saída de página deve ser habilitado no nível do conjunto de sites antes de os perfis de cache de saída de página poderem ser configurados no nível do conjunto de sites ou do aplicativo Web. Se os perfis de cache de saída de página forem habilitados no nível do aplicativo Web, as configurações especificadas no Web.config serão usadas para todos os perfis de cache de saída de página, substituindo todos os valores que tenham sido inseridos através da interface do usuário no nível do conjunto de sites.

Observação

Para usar o cache de saída e as configurações de perfil de cache associadas, você deve usar o recurso Publicação em seu site.

Observação

Há um problema conhecido com o Web Part de pesquisa de conteúdo. A configuração SendContentBeforeQuery no Web Part não funciona corretamente em páginas que usam o cache de saída. Este problema é resolvido na atualização cumulativa do SharePoint Server 2013 para março de 2013. Para obter mais informações, consulte o artigo da Base de Dados de Conhecimento Microsoft 2767999: Descrição da atualização do SharePoint Server 2013: 12 de março de 2013.

Use o procedimento a seguir para definir as configurações de perfil de cache para um aplicativo Web.

Importante

Antes de fazer mudanças no arquivo web.config, faça uma cópia dele usando um nome diferente (por exemplo web.config1), para que se um erro for inserido no arquivo, você possa restaurar a versão original.

Para definir as configurações de perfil de cache de saída de página

  1. Verifique se você tem as seguintes credenciais administrativas: você deve ser um membro do grupo Administradores no computador local para definir as configurações de perfil de cache.

  2. Abra o Gerenciador de Servidor, clique em Ferramentas e, em seguida, em Gerenciador dos Serviços de Informações da Internet (IIS).

  3. No Gestor de Serviços de Informação Internet (IIS), no painel Ligações , expanda o nome do servidor que contém a aplicação Web e, em seguida, expanda Sites para ver a aplicação Web ou as aplicações que foram criadas.

  4. Clique com o botão direito no nome do aplicativo Web para o qual você deseja configurar o cache baseado em disco e clique em Explorar. O Windows Explorer abre com os diretórios do aplicativo Web escolhido listados.

  5. Clique com o botão direito do ratoweb.config, clique em Abrir e selecione Bloco de notas se lhe for pedido para encontrar um programa a utilizar para abrir este ficheiro.

  6. No ficheiro web.config Bloco de Notas, localize a seguinte linha: <OutputCacheProfiles useCacheProfileOverrides="false" varyByHeader="" varyByParam="*" varyByCustom="" varyByRights="true" cacheForEditRights="false" />

  7. Para ativar o perfil de cache ao nível da aplicação Web, altere o useCacheProfileOverrides atributo de "false" para "true".

    Observação

    Se você defini-lo como 'true', as configurações especificadas no Web.config serão usadas para todos os perfis de cache de saída de página. Isso substitui todos os valores que foram inseridos através da interface do usuário no nível do conjunto de sites.

  8. Para substituir o varyByHeader atributo, escreva um parâmetro personalizado conforme especificado na propriedade HttpCachePolicy.VaryByHeaders da entrada de Biblioteca de Classes do .NET Framework.

  9. Para substituir o varyByParam atributo, escreva um parâmetro personalizado conforme especificado na propriedade HttpCachePolicy.VaryByParams da entrada de Biblioteca de Classes do .NET Framework.

  10. Para substituir o varyByCustom atributo, escreva um parâmetro personalizado, conforme especificado na entrada HttpCachePolicy.SetVaryByCustom Method (Método HttpCachePolicy.SetVaryByCustom).

  11. Para substituir o varyByRights atributo, altere o valor de "true" para "false". Isso irá remover o requisito de que os usuários devem ter permissões efetivas idênticas em todos os objetos protegíveis para ver a mesma página em cache que qualquer outro usuário.

  12. Para substituir o cacheForEditRights atributo, altere o cacheForEditRights atributo de "false" para "true". Isso irá ignorar o comportamento normal em que as pessoas com permissões de edição têm suas páginas armazenadas em cache.

  13. Salve o arquivo do Bloco de Notas e feche-o.

Cuidado

Quando guarda uma alteração no ficheiro de web.config, a aplicação Web nos Serviços de Informação Internet (IIS) 7.0 recicla automaticamente. Esta reciclagem pode causar uma breve interrupção no serviço para os sites contidos em tal aplicativo Web e os usuários podem perder o estado da sessão. Para obter informações sobre a reciclagem de aplicações Web no IIS 7.0, consulte Iniciar ou Parar o Servidor Web (IIS 8).

Definir as configurações de cache de objetos

As configurações de cache de objetos pode ser definida no nível do conjunto de sites na interface do usuário por um administrador de conjunto de sites e, por padrão, estão habilitadas. O tamanho máximo de cache pode ser configurado no nível de aplicativo web no servidor web front-end para estabelecer uma restrição na quantidade máxima de memória que o cache usará para todas as coleções de site. Por exemplo, os conjuntos de sites individuais devem ter o cache de objetos definido para 100 MB, enquanto o aplicativo Web deve ser definido a 1 GB. Neste caso, não será usado mais que 1 GB de memória por todos os caches no servidor.

Observação

Para usar o cache de objetos, você deve usar o recurso Publicação em seu site.

Use o procedimento a seguir para definir as configurações de cache de objetos para um aplicativo Web em um servidor Web front-end.

Importante

Antes de fazer mudanças no arquivo web.config, faça uma cópia dele usando um nome diferente (por exemplo web.config1), para que se um erro for inserido no arquivo, você possa restaurar a versão original.

Para definir as configurações de cache de objetos

  1. Verifique se você tem as seguintes credenciais administrativas: você deve ser um membro do grupo Administradores no computador local para definir as configurações de cache de objetos.

  2. Abra o Gerenciador de Servidor, clique em Ferramentas e, em seguida, em Gerenciador dos Serviços de Informações da Internet (IIS).

  3. No Gestor de Serviços de Informação Internet (IIS), no painel Ligações , expanda o nome do servidor que contém a aplicação Web e, em seguida, expanda Sites para ver a aplicação Web ou as aplicações que foram criadas.

  4. Clique com o botão direito no nome do aplicativo Web para o qual você deseja configurar o cache baseado em disco e clique em Explorar. O Windows Explorer abre com os diretórios do aplicativo Web escolhido listados.

  5. Clique com o botão direito do ratoweb.config, clique em Abrir e selecione Bloco de notas se lhe for pedido para encontrar um programa a utilizar para abrir este ficheiro.

  6. No ficheiro Web.config Bloco de Notas, localize a seguinte linha: <ObjectCache maxSize="100" />

  7. Para alterar o tamanho da cache, escreva um novo número para maxSize. O tamanho é expresso em megabytes (MB) e 100 MB é o padrão.

  8. Salve o arquivo do Bloco de Notas e feche-o.

Cuidado

Quando guarda uma alteração no ficheiro de web.config, a aplicação Web nos Serviços de Informação Internet (IIS) 7.0 recicla automaticamente. Esta reciclagem pode causar uma breve interrupção no serviço para os sites contidos em tal aplicativo Web e os usuários podem perder o estado da sessão. Para obter informações sobre a reciclagem de aplicações Web no IIS 7.0, consulte Iniciar ou Parar o Servidor Web (IIS 8).

Confira também

Conceitos

Cache settings operations in SharePoint Server

Planejar armazenamento em cache e desempenho no SharePoint Server