Prevenção de limitação
Prevenção de throttling do KONNEKT inclui duas políticas, uma "controlo da frequência de atualização" política e uma "limitação da taxa de pedidos" 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.
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" estiver definido como 'High'.
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.
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: https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online
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
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. Também pode definir o Filtro Offline 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" 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" e definir a "Prevenção de throttling do SharePoint" política para "Auto".
Quando ativa o registo do KONNEKT para "debug", 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" 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" 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”, 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.
Use "Hard Limit" apenas quando necessário, pois impede o KONNEKT de aceder e comunicar com os endpoints da Microsoft.
Última atualização
Isto foi útil?