> 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/throttling-prevention.md). # Prevenção de throttling **Prevenção de throttling do KONNEKT** inclui duas políticas, uma "[controlo da frequência de atualização](/pt/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" política e uma "[limitação da taxa de pedidos](/pt/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)" política concebida para gerir e controlar a taxa à qual os pedidos são feitos à GraphAPI da Microsoft, garantindo que as ligações ao SharePoint Online (SPO) permanecem estáveis e têm um desempenho ideal. Estas políticas são particularmente úteis para evitar um uso excessivo de recursos e manter uma experiência de utilizador fluida. A utilização das APIs do Microsoft 365 está sujeita a limitações em termos da quantidade de pedidos por período de tempo que uma aplicação pode enviar. Se uma aplicação usar mais recursos, será sujeita a throttling. Pode encontrar mais informações sobre isto em [a documentação da Microsoft](https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online). Como o KONNEKT utiliza a API REST do Microsoft SharePoint Online e a Microsoft Graph API, pode acontecer que as APIs da Microsoft limitem a utilização do seu KONNEKT. Se uma aplicação for sujeita a throttling, a API correspondente (por exemplo, a API REST do SPO) informa o KONNEKT de que tem de esperar um período de tempo definido. Isto começa com alguns segundos e pode aumentar para minutos, dependendo da utilização. Os impactos para o KONNEKT podem ser navegação lenta ou carregamento/escrita de ficheiros. Se o throttling aumentar para minutos, resultará em mensagens de erro a indicar que a unidade não está atualmente disponível. O KONNEKT tem vários mecanismos para reduzir a ocorrência de throttling, que são aplicados automaticamente. ## Cenários comuns para prevenção de throttling ### **Cenário 1: carregamentos de dados de grande volume ou migração de dados** Quando um utilizador tenta carregar um grande número de ficheiros para / ou realiza uma migração de dados no SPO num curto período, o dispositivo pode atingir o limite especificado. ### **Cenário 2: Operações intensivas de leitura** Se um utilizador realizar operações de leitura intensivas, como consultar ou pesquisar um diretório grande (> 1000 itens), o dispositivo pode atingir o limite especificado. Exemplos: * Utilizar a pesquisa do Explorador de Ficheiros em pastas grandes * Percorrer pastas com numerosos ficheiros gráficos ou PDF ### **Cenário 3: Consultas de permissões** Desde a versão 2.10, o KONNEKT também verifica adicionalmente permissões em pastas e ficheiros, uma vez que estas consultas consomem um número maior de unidades de recurso em comparação com as outras operações. O sistema pode atingir o limite especificado muito mais rapidamente, o que pode acionar a prevenção de throttling. As consultas de permissões não serão acionadas se "[Prevenção de throttling do SharePoint](/pt/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" estiver definido como 'High'. {% hint style="warning" %} Em ambientes com carga elevada, todas as medidas podem não ser suficientes para evitar o throttling. O KONNEKT foi criado para trabalho de escritório normal. Se utiliza ficheiros de grande volume (por exemplo, edição de vídeo, design gráfico, CAD) ou lê/escreve gigabytes de dados, o KONNEKT (& SPO) pode não ser a ferramenta mais adequada. Consulte também os nossos [casos de uso](/pt/readme.md#use-cases). {% endhint %} ## **Unidades de recurso** Cada tipo de pedido da GraphAPI consome quantidades diferentes de unidades de recurso: * Leituras de item único: 1 unidade de recurso cada * Operações de escrita e consultas de diretório: 2 unidades de recurso cada * Consultas de permissões: 5 Para detalhes, consulte:\ ## Como posso evitar o throttling? #### As seguintes circunstâncias promovem o throttling: * Utilização de ferramentas de terceiros para cópias de segurança do SPO - especialmente durante o horário de expediente * Utilização de ferramentas que vasculham todo o seu sistema de ficheiros (como renderizadores de pré-visualização, etc.) * Utilização de pastas muito grandes com >1000 ficheiros no primeiro nível da pasta * Utilização excessiva da Pesquisa do Explorador de Ficheiros em grandes Coleções de Sites ou Bibliotecas de Documentos {% hint style="info" %} Considere as seguintes definições e ações para todos os utilizadores de um tenant do Microsoft 365, sem exceções. {% endhint %} #### Para evitar throttling: * Não execute cópias de segurança do SPO durante o horário de expediente. * Se a Pesquisa do Explorador de Ficheiros for inevitável: otimize as pesquisas do Explorador de Ficheiros, concentre-se em pastas ou subpastas específicas para limitar os pedidos da GraphAPI * Manutenção regular: arquive ou remova ficheiros, pastas, Bibliotecas de Documentos e Coleções de Sites desatualizados. * Evite o uso excessivo da Pesquisa do Explorador de Ficheiros em grandes Coleções de Sites ou Bibliotecas de Documentos * Não utilize qualquer renderizador de pré-visualização para recursos do KONNEKT. Veja também [aqui](/pt/configuration/system-settings/offline-attribute.md). Também pode definir o [Filtro Offline](/pt/configuration/system-settings/offline-attribute.md#exclude-dedicated-file-types-from-offline-attribute-filter) para a extensão de ficheiro "YYY" (que não existe), para impedir o Explorador de Ficheiros do Windows de renderizar pré-visualizações para ficheiros PDF. * Segmente os seus dados (não demasiados ficheiros no primeiro nível de uma pasta). * Defina a política "[Prevenção de throttling do SharePoint](/pt/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" para "High" - recomendado apenas até à versão 2.10.2 do KONNEKT * A partir da versão 2.11.0, recomendamos ativar "[throttling do lado do cliente](/pt/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)" e definir a "[Prevenção de throttling do SharePoint](/pt/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" política para "Auto". Quando ativa o [registo do KONNEKT para "debug"](/pt/configuration/system-settings/logging.md#log-level), verá entradas de registo com "`ThrottlingHook: É necessário aguardar Xs antes de iniciar`" (onde X representa a quantidade de segundos que o SPO nos quer fazer esperar). Entradas de registo que contenham "`[Sharepoint] UpdateDrives: Ignorando o volume devido à prevenção de throttling.`" NÃO são causadas por throttling do SharePoint. Indicam operações normais para prevenir throttling - nada com que se preocupar. ;-) ## **Como funciona** A política "[controlo da frequência de atualização](/pt/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" limita as solicitações por ciclos de atualização aprimorados, por exemplo, atualizando as Coleções de Sites dos utilizadores. A política "[limitação da taxa de pedidos](/pt/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)" política funciona monitorizando o número de pedidos e as unidades de recurso correspondentes realizadas dentro de uma janela de tempo especificada e aplicando limites a esses pedidos. Esta política, “[throttling do lado do cliente](/pt/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)”, inclui **suaves** e **rígidos** : * **Limite suave**\ Quando o limite suave for atingido, o sistema começará a limitar os pedidos. Isto significa que a maioria das operações será atrasada por um curto período (por exemplo, 2 segundos), e o nível de prevenção de throttling mudará para HIGH. Algumas operações, como trabalhos de carregamento oportunistas e operações de leitura antecipada, serão adiadas até que a quantidade de pedidos fique abaixo do limite suave. * **Limite rígido**\ Quando o limite rígido for atingido, o sistema deixará de enviar quaisquer pedidos. A aplicação apresentará uma mensagem de erro até que o fim da janela de tempo seja alcançado. {% hint style="warning" %} Use "Hard Limit" apenas quando necessário, pois impede o KONNEKT de aceder e comunicar com os endpoints da Microsoft. {% endhint %} --- # 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/throttling-prevention.md?ask=&goal= ``` `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.