一貫したパフォーマンスを確保するために、Wdataの機能と開発者アプリケーションプログラミングインターフェース(API)(カスタム統合を使用してWorkivaプラットフォームへのデータ接続を可能にする)では、いくつかの制限が適用されます。
これらの制約はワークスペースの境界となりますが、可能な限りデータセットの数を制限することをお勧めします。追加のデータセットは処理時間に連鎖的な影響を及ぼし、これらの制限に近づいたり、特に複雑なクエリを実行したりすると、パフォーマンスが低下する場合があります。
テーブル、クエリ、ビュー、チェーン
Wdataは、テーブル、クエリ、ビュー、チェーンにいくつかの機能制限を適用します。
テーブル
機能 | 制限 |
---|---|
ファイルのアップロード |
推奨ファイルサイズ: 300MB以下 最大ファイルサイズ:1 GB ファイル形式: CSVまたはTSV 注:ZIPファイルを使用してアップロードサイズを減らすことはできますが、クエリのパフォーマンスは向上しません。 |
テーブルあたりの列数 | 150 |
ファクトテーブル | 10億行 |
ディメンションテーブル |
推奨: 100万行以下 最大: 200万行 |
スプレッドシートごとの接続されたデータセット | 100 |
タグ値 |
最大: 300 タグ値を追加するのではなく、個別のルックアップテーブルを作成するか、クエリを使用してスプレッドシートに結合テーブルを作成することをお勧めします。 |
クエリ
機能 | 制限 |
---|---|
クエリあたりのパラメータの数 | 30 |
クエリのパラメータ名 | 256文字 |
パラメータ選択リストあたりのアイテム数 | 512 |
クエリSQLエディタステートメント | 30,000文字 |
スプレッドシート、ドキュメント、またはプレゼンテーションごとの接続されたクエリ | 100 |
スプレッドシートあたりのセル数 | 2,000,000 |
SQLエディタ内のUNION 演算子 |
20 |
ビュー
機能 | 制限 |
---|---|
ビューあたりのクエリ行数 | 1,000,000 |
チェーン
機能 | 制限 |
---|---|
接続 | 「ソリューション」をサブスクライブでは1つ、「エンタープライズ」のサブスクライブでは5つが提供されます。追加の接続を購入するには、カスタマーサクセスマネージャーにお問い合わせ下さい。 |
変数 | 1チェーンあたり100 |
APIレート制限
APIは、現在のシステム負荷または過度の頻度に基づき、リクエストにレート制限をかける場合があります。 これらの制限を超えると、429 Too Many Requests
というステータスコードでエラー応答が返されます。
APIはリクエストの長さを10分に制限していることにも注意してください。
管理タスク
リクエスト | ワークスペースごとの1分あたりの制限 |
単一のワークスペースを削除 | 5 |
単一のワークスペースをエクスポート | 5 |
データのインポート | 5 |
サイズ別にワークスペースファイルを取得 | 10 |
ワークスペースクエリの使用状況を取得 | 55 |
ワークスペースのアップロードの使用状況を取得 | 50 |
ファイルの検証 | 5 |
テーブルの検証 | 5 |
チェーン
API には、1 日あたりの制限と短期間の制限の両方が適用されます。
制限:
- APIへのリクエストは24時間以内に5万件
- 20秒間に100件のリクエストのバースト制限
接続管理
リクエスト | ワークスペースごとの1分あたりの制限 |
接続を更新 | 200 |
接続のバッチを更新 | 1 |
接続ステータスの更新を取得 | 1000 |
ファイル管理
リクエスト | ワークスペースごとの1分あたりの制限 |
ファイルのリストを取得 | 650 |
単一のファイルをアップロード | 50 |
単一のファイルを削除 | 50 |
単一のファイルを取得 | 150 |
単一のファイルをダウンロード | 50 |
エラーを取得 | 20 |
ファイルをスプレッドシートにエクスポート | 5 |
フォルダ管理
リクエスト | ワークスペースごとの1分あたりの制限 |
検索 | 150 |
フォルダのリストを取得 | 150 |
新しいフォルダを作成 | 150 |
単一のフォルダを削除 | 150 |
単一のフォルダを取得 | 150 |
単一のフォルダを更新 | 150 |
フォルダの内容のリストを取得 | 150 |
コンテンツをフォルダに移動 | 150 |
パラメータ管理
リクエスト | ワークスペースごとの1分あたりの制限 |
パラメータを取得 | 50 |
パラメータの作成 | 10 |
パラメータの削除 | 50 |
パラメータの取得 | 10 |
パラメータの更新 | 10 |
ピボットビュー管理
リクエスト | ワークスペースごとの1分あたりの制限 |
ピボットビューのリストを取得 | 50 |
新しいピボットビューを作成 | 10 |
単一のピボットビューを削除 | 50 |
単一のピボットビューを取得 | 50 |
単一のピボットビューを更新 | 10 |
クエリ管理
リクエスト | ワークスペースごとの1分あたりの制限 |
クエリのリストを取得 | 192 |
新しいクエリを作成 | 57 |
クエリ列データを取得 | 255 |
クエリを解析してそれが有効か否か判断 | 255 |
単一のクエリを削除 | 150 |
単一のクエリを取得 | 1139 |
単一のクエリを更新 | 93 |
依存関係を取得 | 10 |
従属のリストを取得 | 60 |
クエリ結果のリストを取得 | 39 |
クエリを実行 | 400 |
実行中のクエリをキャンセル | 25 |
単一のクエリ結果を取得 | 1200 |
クエリ結果をダウンロード | 100 |
クエリ結果のスプレッドシートへのエクスポート | 400 |
リスト管理を選択
リクエスト | ワークスペースごとの1分あたりの制限 |
選択リストのリストを取得 | 10 |
新しい選択リストを作成 | 36 |
単一の選択リストを削除 | 10 |
単一のリストを取得 | 108 |
単一の選択リストを更新 | 12 |
共有テーブル管理
リクエスト | ワークスペースごとの1分あたりの制限 |
共有テーブルのリストを取得 | 90 |
新しい共有テーブルを作成 | 8 |
単一の共有テーブルを削除 | 10 |
単一の共有テーブルを取得 | 366 |
テーブル管理
リクエスト | ワークスペースごとの1分あたりの制限 |
テーブルのリストを取得 | 220 |
新しいテーブルを作成 | 100 |
単一のテーブルを削除 | 45 |
単一のテーブルを取得 | 700 |
単一のテーブルを更新 | 25 |
従属のリストを取得 | 60 |
単一のファイルをインポート | 30 |
単一のファイルのインポートを解除 | 170 |
インポート情報を取得 | 50 |
スプレッドシートからインポート | 10 |
タグ管理
リクエスト | ワークスペースごとの1分あたりの制限 |
タグのリストを取得 | 50 |
新しいタグを作成 | 10 |
単一のタグを削除 | 10 |
単一のタグを更新 | 10 |
トークン管理
リクエスト | ワークスペースごとの1分あたりの制限 |
新しいトークンを作成 | 150 |
ユーティリティ
リクエスト | ワークスペースごとの1分あたりの制限 |
日付を解析 | 10 |
ストレージとクエリの制限
APIは現在、サブスクリプションのレベル別にライフタイムストレージと年間クエリのサイズに制限を設けています。これらの制限は、クエリによって作成された結果のサイズではなく、スキャンされた合計バイト数に基づいています。ワークスペースの所有者は、使用状況を追跡して組織がこれらの制限内にあることを確認できます。
サブスクリプション | ライフタイムストレージ | 年間クエリ |
---|---|---|
ソリューション | 100GB | 120TB |
エンタープライズ | 500GB | 3,000TB |
実際には、5年以上の1GBストレージには、次を含む800万のレコードが含まれます。
- 月次実績を10ディメンションにカット
- 月次ローリングの12ヶ月予測
- 予算データ
ストレージまたはクエリのニーズに基づいてサブスクリプションのレベルを選択することをお勧めします。例えば次のような例が挙げられます。
- ソリューションサブスクリプションを選択すると、100GBのデータを含むテーブルを年に1,200回クエリ、または50GBのデータを含むテーブルを年に2,400回クエリする事ができます。
- エンタープライズサブスクリプションでは、3,000TBまでクエリ制限が拡張されるため、データを1年間に300万回クエリする事ができます。
追加のライフタイムストレージを購入するには、アカウント所有者またはカスタマーサクセスマネージャーまでお問い合わせください。
注:これらはハードキャップであり、制限に達すると今後はインポートやクエリを完了できなくなります。例えば、ストレージ制限を超えてデータセットをテーブルにインポートすることはできず、クエリ制限を超えるとWdataクエリは失敗します。
タイムアウト
Workiva Wdata APIでは現在、リクエストの長さが10分に制限されています。
タイムアウトは接続先のWorkiva APIによって異なる場合があります。詳しくはWorkiva開発者ハブをご覧ください。
ペイロードサイズ
Workiva APIは、リクエストのサイズを最大10485760バイト (10MB) に制限します。これは、すべてのWorkiva APIに設定された制限です。
暗号化
データのプライバシーと整合性を確保するために、API 呼び出しでは、トランスポート層セキュリティ (TLS) 1.3、高度な暗号化標準 (AES) 256 が使用されます。