> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/pt/configuration/system-settings/cache-setting.md).

# Definições de cache

{% hint style="info" %}
Esta política aplica-se à versão 2.0 e superior
{% endhint %}

## Noções básicas

Todos os ficheiros, que são lidos ou escritos no SharePoint Online através do KONNEKT, são temporariamente colocados em cache no disco local.

O diretório da cache está localizado em: `%localappdata%\konnekt\cache`

Esta política define o comportamento de cache do KONNEKT.

O KONNEKT usa a cache para diferentes fins:

* Ficheiros que estão atualmente abertos pelo utilizador
* Ficheiros que precisam de ser carregados (cache de escrita)
* Ficheiros que estão fechados (cache de leitura)

## **Definições**

### **TTL da cache (Tempo de vida)**

Durante quanto tempo (em minutos) os documentos fechados (cache de leitura) permanecerão na cache. Sem esta definição, o TTL mantém-se automaticamente em 60 minutos - em "pressão normal". Este valor tem de ser preenchido no campo de entrada se a política estiver ativada. A cache é sempre limpa após um reinício do KONNEKT.

* Unidade: Minutos
* Valor mínimo: 0
* Valor máximo:
  * 2880 (versões do KONNEKT < 2.6.0)
  * 60480 (versão do KONNEKT 2.6.0 ou posterior)

### **Tamanho fixo da cache**

Qual é o tamanho (em megabytes) da pasta de cache do KONNEKT. Este valor tem de ser preenchido no campo de entrada se a política estiver ativada.

* Unidade: Megabytes
* Valor mínimo: 0 => o tamanho da cache será calculado a partir do espaço livre em disco (predefinição)
* Valor máximo: 20000

## **Nos bastidores**

### Estados de pressão

A cache funciona em diferentes estados de pressão:

* **Pressão normal:** A cache é utilizada abaixo dos valores críticos. Os ficheiros fechados serão mantidos na cache de leitura até ao valor de TTL.
* **Pressão elevada de leitura:** A cache está preenchida com demasiados ficheiros fechados. A cache de leitura será eliminada.
* **Pressão elevada de escrita:** A cache está a manter muitos ficheiros enfileirados para carregamento. Além disso, as operações de escrita serão limitadas para esvaziar a fila de carregamento.
* **Pressão crítica de escrita:** A cache está quase cheia com ficheiros enfileirados para carregamento. Além disso, as operações de escrita serão significativamente limitadas para esvaziar a fila de carregamento.
* **Cache cheia:** A cache está completamente ocupada. Os pedidos para abrir mais ficheiros serão rejeitados.

### Cálculo automático do tamanho da cache

* **Tamanho da cache a partir do cálculo do espaço livre em disco**\
  *sizeMax* = (*FreeDiskSize* + *CacheSize*) \* 75%
* **Cálculo de pressão elevada**\
  *pressure* = *sizeUsed* / *sizeMax* >= 80%
* **Cálculo de pressão elevada de escrita**\
  *writePressure* = *uploadSize* / *sizeMax* >= 60%
* **Cálculo de pressão crítica de escrita**\
  *writePressure* = *uploadSize* / *sizeMax* >= 80%
* **Cálculo da cache cheia**\
  *sizeUsed* >= *sizeMax*

{% hint style="warning" %}
Para aplicar a política, tem de **reiniciar a máquina**
{% endhint %}

## **Há várias maneiras de aplicar a política:**

* manualmente, adicionando a chave no registro nas configurações de registro da máquina ou do usuário
* através da GPO, [verificar as definições através da GPO](/pt/configuration/management-options/settings-via-gpo.md)
* aplicando políticas via Intune, veja [definição para dispositivos geridos pelo Intune](/pt/configuration/management-options/setting-for-intune-managed-devices-1/intune-system-settings.md#cache)

![](/files/9c5caa090da012656c18946776c50e4551f53dc9)

#### **Políticas** armazenadas em:

`HKEY_CURRENT_USER\SOFTWARE\Policies\glueckkanja\Konnekt`

`HKEY_LOCAL_MACHINE\SOFTWARE\Policies\glueckkanja\Konnekt`

{% hint style="warning" %}
Para aplicar a política, tem de **reiniciar a máquina**
{% endhint %}

## Recomendações para ambientes VDI

Recomendamos as seguintes definições para ambientes VDI em geral, mas certifique-se de que esta definição se adequa ao seu caso de utilização do KONNEKT:

**TTL da cache**: 10-60 min

**Tamanho da cache**: 500-1000 MB

Também poderá querer [restringir o tamanho dos ficheiros](/pt/configuration/system-settings/open-file-size-limitations.md), que está a ler do SharePoint Online:

**OneDriveOpenFilesLargerThanReadOnly**: 100-500 MB (= 104,857,600 - 524,288,000 bytes)

**OneDriveDoNotOpenFilesLargerThan**: 200-1000 MB (= 209,715,200 - 1,048,576,000 bytes)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.konnekt.io/pt/configuration/system-settings/cache-setting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
