Definir as configurações de cache para um aplicativo Web no SharePoint Server

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 o cache BLOB baseado em disco, os perfis de cache de saída de página e o cache de objetos para um aplicativo 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 permitem verificar se as configurações de cache do farm estão corretas e se o cache está sendo executado com desempenho máximo. Para obter mais informações, consulte Monitorar o desempenho do 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, consulte Liberar o cache BLOB no SharePoint Server.

Para obter mais informações, consulte Operações de configuraçõ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 Gerenciador do IIS (Serviços de Informações da Internet), no painel Conexões , expanda o nome do servidor que contém o aplicativo Web e, em seguida, expanda Sites para exibir o aplicativo ou aplicativos Web que foram criados.

  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 no Bloco de Notas e em OK.

  6. No arquivo 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 padrão de uma imagem ao usar representações de imagem é de 40 megapixels. Se você quiser modificar esse valor, precisará 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" /> Isso definirá o tamanho máximo da imagem para que as representações de imagem funcionem em torno de 100 megapixels.

  7. Nesta linha, altere o location atributo para especificar um diretório que tenha espaço suficiente para acomodar o tamanho do 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 arquivo da lista de tipos de arquivo a serem armazenados em cache, para o path atributo, modifique a expressão regular para incluir ou remover a extensão de arquivo apropriada. 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 do cache, digite 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 habilitar o cache BLOB, altere o enabled atributo, de "false" para "true".

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

Cuidado

Quando você salva uma alteração no arquivo web.config, o aplicativo Web no IIS (Serviços de Informações da Internet) 7.0 é reciclado 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 aplicativos Web no IIS 7.0, consulte 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. Esse problema foi resolvido na atualização cumulativa do SharePoint Server 2013 de 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 Gerenciador do IIS (Serviços de Informações da Internet), no painel Conexões , expanda o nome do servidor que contém o aplicativo Web e, em seguida, expanda Sites para exibir o aplicativo ou aplicativos Web que foram criados.

  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 mouseweb.config, clique em Abrir e escolha Bloco de Notas se você for solicitado a encontrar um programa para usar para abrir este arquivo.

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

  7. Para habilitar o perfil de cache no nível do aplicativo 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, digite um parâmetro personalizado conforme especificado na entrada da Biblioteca de Classes do .NET Framework Propriedade HttpCachePolicy.VaryByHeaders.

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

  10. Para substituir o varyByCustom atributo, digite um parâmetro personalizado, conforme especificado no método HttpCachePolicy.SetVaryByCustom da Biblioteca de Classes do .NET Framework.

  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 você salva uma alteração no arquivo web.config, o aplicativo Web no IIS (Serviços de Informações da Internet) 7.0 é reciclado 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 aplicativos 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 Gerenciador do IIS (Serviços de Informações da Internet), no painel Conexões , expanda o nome do servidor que contém o aplicativo Web e, em seguida, expanda Sites para exibir o aplicativo ou aplicativos Web que foram criados.

  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 mouseweb.config, clique em Abrir e selecione Bloco de Notas se for solicitado a encontrar um programa para abrir esse arquivo.

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

  7. Para alterar o tamanho do cache, digite 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 você salva uma alteração no arquivo web.config, o aplicativo Web no IIS (Serviços de Informações da Internet) 7.0 é reciclado 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 aplicativos 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