# Definições de cache

{% hint style="info" %}
Esta política é aplicável à 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 armazenados em cache no disco local.&#x20;

A pasta de cache está localizada em: `%localappdata%\konnekt\cache`

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

O KONNEKT utiliza 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**&#x20;

### **Cache TTL (Time To Live)**

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

* Dimensão: 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 mais recente)

### **Tamanho fixo da Cache**

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

* Dimensão: Megabytes
* Valor mínimo: 0 => o tamanho da cache será calculado com base no espaço livre em disco (predefinição)
* Valor máximo: 20000

## **Nos bastidores**

### Estados de pressão

A cache opera 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 guardar muitos ficheiros em fila para upload. Além disso, as operações de escrita serão limitadas para esvaziar a fila de upload.
* **Pressão crítica de escrita:** A cache está quase cheia de ficheiros em fila para upload. Além disso, as operações de escrita serão significativamente limitadas para esvaziar a fila de upload.
* **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**\
  &#x20;*sizeMax* = (*FreeDiskSize* + *CacheSize*) \* 75%
* **Cálculo de pressão elevada**\
  &#x20;*pressure* = *sizeUsed* / *sizeMax* >= 80%
* **Cálculo de pressão elevada de escrita**\
  &#x20;*writePressure* = *uploadSize* / *sizeMax* >= 60%
* **Cálculo de pressão crítica de escrita**\
  &#x20;*writePressure* = *uploadSize* / *sizeMax* >= 80%
* **Cálculo da cache preenchida**\
  &#x20;*sizeUsed* >= *sizeMax*

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

## **Existem várias formas de aplicar a política:**

* manualmente, adicionando a chave no registo sob as definições de registo da máquina ou do utilizador
* via GPO, [verificar as definições via GPO](/pt/configuration/management-options/settings-via-gpo.md)
* enviando políticas através do Intune, consulte [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, em geral, as seguintes definições para ambientes VDI, mas certifique-se de que esta definição se adequa ao seu caso de utilização do KONNEKT:&#x20;

**Cache TTL**: 10-60 min

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

Também pode querer [restringir o tamanho do ficheiro](/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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
