Para ajudar a garantir um desempenho consistente, os recursos do Wdata e a Interface de Programação de Aplicativos (API) para desenvolvedores - que permite a integração personalizada para conectar seus dados à plataforma Workiva - impõem vários limites.
Embora essas restrições forneçam limites para o seu espaço de trabalho, recomendamos que você limite o número de conjuntos de dados sempre que possível. Conjuntos de dados adicionais têm um efeito em cascata no tempo de processamento, e você pode notar um desempenho mais lento ao se aproximar desses limites ou ao executar consultas particularmente complexas.
Tabelas, consultas, exibições e cadeias
O Wdata impõe uma série de limites de recursos em tabelas, consultas, exibições e cadeias.
Tabelas
| Recurso | Limite |
|---|---|
| Carregamento de arquivos |
Tamanho de arquivo recomendado: 300 MB ou menos Tamanho máximo do arquivo: 1 GB Formato do arquivo: CSV ou TSV Nota: Os arquivos ZIP podem ser usados para reduzir o tamanho do carregamento, mas não resultarão em melhor desempenho da consulta. |
| Colunas por tabela | 150 |
| Tabelas de fatos | 1 bilhão de linhas |
| Tabelas de dimensões |
Recomendado: 1 milhão de linhas ou menos Máximo: 2 milhões de linhas |
| Conexões por planilha | 300 de entrada e 300 de saída |
| VALORES DA ETIQUETA |
Máximo: 300 Em vez de adicionar valores de tag adicionais, recomendamos que você crie uma tabela de pesquisa separada ou use as consultas para criar uma tabela de junção em planilhas. |
Consultas
| Recurso | Limite |
|---|---|
| Parâmetros por consulta | 30 |
| Nome do parâmetro de consulta | 256 caracteres |
| Itens por lista de seleção de parâmetros | 512 |
| Declaração do Query SQL Editor | 30.000 caracteres |
| Consultas conectadas por planilha, documento ou apresentação | 100 |
| Células por planilha | 2,000,000 |
Operadores UNION no SQL Editor |
20 |
Exibições
| Recurso | Limite |
|---|---|
| Linhas de consulta por visualização | 1,000,000 |
Nota: Tente reduzir o tamanho da consulta adicionando uma cláusula LIMIT.
Cadeias
| Recurso | Limite |
|---|---|
| Conexões | Uma fornecida com uma assinatura do Solution; cinco com o Enterprise. Para adquirir conexões adicionais, entre em contato com o gerente do Customer Success. |
| Variáveis | Não aplicamos mais um limite, mas observamos uma capacidade de resposta degradada do aplicativo quando as cadeias se aproximam do intervalo de mais de 1.000 variáveis. |
| Notificações |
40 MB para e-mails enviados Nota: Esse limite de envio não afeta o limite de recebimento definido por alguns provedores de terceiros. |
Limites de taxa da API
Os limites de taxa abaixo são aplicados no nível do espaço de trabalho e não por usuário. Se você exceder esses limites, receberá uma resposta de erro com um código de status 429 Too Many Requests.
Você também deve observar que a API limita a duração de qualquer solicitação a 10 minutos.
Observação: A API pode limitar adicionalmente suas solicitações com base na carga atual do sistema ou na frequência excessiva. Se você executar um conjunto de dados grande em um curto período de tempo, poderá sofrer um pequeno atraso para garantir o desempenho do sistema.
Tarefas administrativas
| Solicitação | Limite por minuto por espaço de trabalho |
| Excluir um único espaço de trabalho | 5 |
| Exportar um único espaço de trabalho | 5 |
| Importar dados | 5 |
| Recuperar arquivos de espaço de trabalho por tamanho | 10 |
| Recuperar o uso da consulta do espaço de trabalho | 55 |
| Recuperar o uso do upload do espaço de trabalho | 50 |
| Validar arquivos | 5 |
| Validar tabelas | 5 |
Correntes
Os limites diários e de curto prazo se aplicam à API.
Limites:
- 50.000 solicitações à API em um período de 24 horas
- Limite de explosão de 100 solicitações em um período de 20 segundos
Gerenciamento de conexões
| Solicitação | Limite por minuto por espaço de trabalho |
| Obter detalhes da conexão | 515 |
| Listar conexões | 2000 |
| Atualizar conexão | 203 |
| Atualizar lote de conexões | 20 |
| Obter o status de uma atualização em lote | 1000 |
| Obter o status da conexão de atualização | 1000 |
Gerenciamento de arquivos
| Solicitação | Limite por minuto por espaço de trabalho |
| Recuperar uma lista de arquivos | 650 |
| Fazer upload de um único arquivo | 50 |
| Excluir um único arquivo | 50 |
| Recuperar um único arquivo | 150 |
| Baixar um único arquivo | 50 |
| Recuperar erros | 20 |
| Exportar um arquivo para planilhas | 5 |
Gerenciamento de pastas
| Solicitação | Limite por minuto por espaço de trabalho |
| Pesquisar | 150 |
| Recuperar uma lista de pastas | 150 |
| Criar uma nova pasta | 150 |
| Excluir uma única pasta | 150 |
| Recuperar uma única pasta | 150 |
| Atualizar uma única pasta | 150 |
| Recuperar uma lista de conteúdos de pastas | 150 |
| Mover conteúdo para uma pasta | 150 |
Gerenciamento de parâmetros
| Solicitação | Limite por minuto por espaço de trabalho |
| Obter parâmetros | 50 |
| Criar parâmetro | 10 |
| Excluir parâmetro | 50 |
| Obter parâmetro | 10 |
| Atualizar parâmetro | 10 |
Gerenciamento da visualização dinâmica
| Solicitação | Limite por minuto por espaço de trabalho |
| Recuperar uma lista de exibições dinâmicas | 50 |
| Criar uma nova visualização dinâmica | 10 |
| Excluir uma única exibição dinâmica | 50 |
| Recuperar uma única exibição dinâmica | 50 |
| Atualizar uma única exibição dinâmica | 10 |
Gerenciamento de consultas
| Solicitação | Limite por minuto por espaço de trabalho |
| Recuperar a lista de consultas | 192 |
| Criar uma nova consulta | 57 |
| Recuperar dados da coluna de consulta | 255 |
| Analisar a consulta para determinar se ela é válida | 255 |
| Excluir uma única consulta | 150 |
| Recuperar uma única consulta | 1139 |
| Atualizar uma única consulta | 93 |
| Recuperar dependências | 10 |
| Recuperar uma lista de dependentes | 60 |
| Recuperar uma lista de resultados da consulta | 39 |
| Executar uma consulta | 400 |
| Cancelar uma consulta em execução | 25 |
| Recuperar um único resultado de consulta | 1200 |
| Baixar um resultado de consulta | 100 |
| Exportar o resultado da consulta para planilhas | 400 |
Selecionar gerenciamento de listas
| Solicitação | Limite por minuto por espaço de trabalho |
| Recuperar uma lista de listas de seleção | 10 |
| Criar uma nova lista de seleção | 36 |
| Excluir uma única lista de seleção | 10 |
| Recuperar uma única lista | 108 |
| Atualizar uma única lista de seleção | 12 |
Gerenciamento de tabelas compartilhadas
| Solicitação | Limite por minuto por espaço de trabalho |
| Recuperar uma lista de tabelas compartilhadas | 90 |
| Criar uma nova tabela compartilhada | 8 |
| Excluir uma única tabela compartilhada | 10 |
| Recuperar uma única tabela compartilhada | 366 |
Gerenciamento da tabela
| Solicitação | Limite por minuto por espaço de trabalho |
| Recuperar uma lista de tabelas | 220 |
| Criar uma nova tabela | 100 |
| Excluir uma única tabela | 45 |
| Recuperar uma única tabela | 700 |
| Atualizar uma única tabela | 25 |
| Recuperar uma lista de dependentes | 60 |
| Importar um único arquivo | 50 |
| Desimportar um único arquivo | 170 |
| Recuperar informações de importação | 50 |
| Importar de planilhas | 10 |
Gerenciamento de tags
| Solicitação | Limite por minuto por espaço de trabalho |
| Recuperar uma lista de tags | 50 |
| Criar uma nova tag | 10 |
| Excluir uma única tag | 10 |
| Atualizar uma única tag | 10 |
Gerenciamento de tokens
| Solicitação | Limite por minuto por espaço de trabalho |
| Criar um novo token | 150 |
Utilitários
| Solicitação | Limite por minuto por espaço de trabalho |
| Analisar uma data | 10 |
<!--
Note: Other requests are currently unlimited. However, Workiva reserves the right to impose additional limits as necessary to ensure effective performance.
-->
Limites de armazenamento e de consulta
Atualmente, a API limita o tamanho do armazenamento vitalício e das consultas anuais por nível de assinatura. Esses limites são baseados no total de bytes digitalizados, não no tamanho do resultado criado pela consulta. Os proprietários de espaços de trabalho podem monitorar seu uso para verificar se a organização está dentro desses limites.
| Assinatura | Armazenamento vitalício | Consulta anual |
|---|---|---|
| Solução | 100GB | 120TB |
| Empresa | 500GB | 3.000TB |
Em termos reais, apenas 1 GB de armazenamento ao longo de cinco anos pode conter 8 milhões de registros, incluindo:
- Dados reais mensais cortados em 10 dimensões
- Previsões mensais de 12 meses
- Dados orçamentários
Recomendamos que você escolha um nível de assinatura com base nas suas necessidades de armazenamento ou de consulta. Por exemplo:
- Com uma assinatura Solution, você pode consultar uma tabela com 100 GB de dados 1.200 vezes por ano ou uma tabela com 50 GB de dados, 2.400 vezes por ano.
- Com uma assinatura Enterprise, o limite de consulta de 3000 TB permite que você consulte os dados 3 milhões de vezes por ano.
Para adquirir armazenamento vitalício adicional, entre em contato com o proprietário da conta ou com o gerente de sucesso do cliente.
Observação: Esses são limites rígidos, o que significa que importações ou consultas futuras não poderão ser concluídas depois que o limite for atingido. Por exemplo, você não poderá importar conjuntos de dados para tabelas além do limite de armazenamento, e as consultas do Wdata falharão quando o limite de consultas for excedido.
Tempo limite
Atualmente, a API Workiva Wdata limita a duração de qualquer solicitação a 10 minutos.
Observe que os tempos limite podem variar dependendo da API da Workiva à qual você está se conectando. Saiba mais em Workiva Developer Hub.
Tamanho da carga útil
A API da Workiva limita o tamanho de qualquer solicitação a um máximo de 10485760 bytes (10 MB). Esse é um limite definido para todas as APIs da Workiva.
Criptografia
Para garantir a privacidade e a integridade dos dados, as chamadas de API usam Transport Layer Security (TLS) 1.3; Advanced Encryption Standard (AES) 256 em repouso.