​

最佳做法與常見問題

​

最佳做法

• 每個效能等級都附帶特定數量的快取。建議您計算每日資料使用量，並決定要在快取中保留多少天的資料。保留少量緩衝或掌握明確的資料使用量，可讓任何執行查詢的人知道何時能預期最佳效能。也建議依據該預期效能執行視覺效果，以快速取得結果。
  • 例如，某工作室每天的資料使用量為 5 GB。選取 450+ 的快取大小可讓快取保留 90 天的資料。在 90 天的滾動時段內執行所有視覺效果將會很有效率。聯結、聯集和進階查詢也會很有效率。另一個選項是將即時視覺效果主要聚焦於 30 天時段，並在上班時間將快取大小設定為最多 90 天，在非上班時間設定為 30 天。這能大幅節省成本。也請記住，快取中的資料是經過壓縮的。
• Power BI 等資料視覺效果平台通常會針對單一視覺效果執行多個查詢。建議依序更新視覺效果。如果負載沉重或有許多使用者在使用，可以考慮將效能等級提高到允許更多並行查詢的等級，以釋出同時查詢的容量供外部工具和分析師使用。
• 排程調整最常見的使用案例，是在標準上班時間擴大規模，並在下班後和週末縮小規模。如果要大幅變更效能等級 (例如從等級 3 變更為 8)，建議您打算在較高效能等級維持數小時。快速將 TB 等級的資料載入和移出快取，是一種沒有效率的資源使用方式。所有其他限制都會立即提高，因此您可以視需要選擇進行調整變更。
• 排程調整與手動調整並非互斥。如果您發現在一天中需要更多資源，可以進行手動變更，排程調整仍會如預期般繼續運作。
• 減少資料儲存可能會導致資料遺失。嘗試減少儲存時，您會收到警告訊息「Selected retention setting is lower than current setting. Doing so may result in a loss of data.」。由於儲存成本低廉，建議採用長期保留。
• Insights 管理命令可讓您建立和更新自訂資料表。對於核心報告和常用的資料表，建立自訂彙總資料表會很有幫助。彙總資料表的資料使用量通常比來源資料小。這能提高查詢效能，並減少對較高效能等級的需求。
  • 若要自動化資料彙總，我們建議使用 Azure Data Factory，這是一個低成本且可擴充的自動化選項。如需使用 Azure Data Factory 的詳細資訊，請參閱連線一節。
• 使用時間戳記限制查詢是良好的資料管理做法。您不需要一次提取過去數天的所有資料。

​

常見問題

​

如何查詢資料？

1. 最簡單的方式是使用我們內建的資料總管。
2. 連線一節詳細說明了更多存取資料的方式。

​

我傳送了 Microsoft 驗證連結 (使用 Azure Active Directory)，但沒有作用，發生了什麼事？

• 如果您已經有 PlayFab 帳戶，必須先登出，才能接受使用不同驗證方法的邀請。

​

為什麼我嘗試變更效能等級或資料保留時會收到錯誤？

1. 如果您尚未註冊付費帳戶，將無法變更效能等級、保留、匯出及部分管理命令。
2. 如果您的 Insights 叢集目前正在變更效能等級，您必須等到變更完成。

​

我可以在免費和付費效能等級之間切換嗎？

• 當然可以！如果您目前不需要任何付費功能，可以還原回免費層。

​

如何將資料放入我的 Insights 叢集？

1. 大部分的 PlayFab 服務會自動為您產生資料。
2. 您也可以透過 PlayStream 或我們的 Telemetry 系統實作自己的遙測。
3. 您可以使用管理命令來擷取自訂資料集。

​

PlayFab 事件的標準資料結構描述是什麼？

• 在 PlayFab Insights 中，我們會將所有事件的所有資料載入單一資料表。此資料表名為 [‘events.all’]。在該資料表內，您會看到名為 “EventData” 的資料行，其中包含每個事件的 JSON 資訊承載。如需 events.all 資料表的完整資訊，請參閱關於 events.all 資料表。

​

為什麼我無法撰寫 SQL？

• 目前在大部分情況下，我們只支援 KQL (Kusto 查詢語言) 查詢。我們正積極研究新增 SQL 支援。雖然 KQL 需要一些時間來適應，但我們認為您熟悉之後會喜歡它。如需將 SQL 轉換為 Kusto 查詢的資訊，請參閱 SQL 到 Kusto 查詢轉譯。

​

我的 Insights 效能等級中的每秒事件數與傳送 PlayStream 事件的成本有何差異？

• Insights 效能等級中的每秒事件數，代表透過任何方式擷取到您叢集中的資料。PlayStream 寫入事件和寫入遙測事件會分開計費，代表寫入雲端的成本。

​

我可以使用比管理頁面上所見更高的效能等級嗎？

• 請向我們提交支援票證，我們會與您聯絡，安排符合您需求的方案。

​

PlayFab Insights 背後的基礎技術是什麼？

• PlayFab Insights 使用 Azure 資料總管 (Kusto) 的特殊變體。

​

為什麼使用自訂查詢匯出時，我的資料結構描述會不同？

• 自訂查詢輸出包含來自 ETL (擷取、轉換、載入) 程序的詳細資料。其中會包含一些額外的資料行。這些資料行在查詢環境中是隱藏的，因為它們沒有用途。

​

如果我將保留設定減少到少於我擁有資料的總天數，會發生什麼事？

• 系統會警告您，減少保留可能會刪除資料。例如，如果您已營運一年，並將保留減少為六個月，則只會保存最近六個月的資料，其餘資料會被捨棄。

​

如何增加查詢的逾時時間？

• 查詢的逾時限制與效能等級中定義的計算能力相關。請參閱效能與保留中計算能力下的計算能力表。

​

我可以傳送的遙測數量有限制嗎？

• WriteTelemetryEvents API 呼叫有下列限制：

  限制名稱	限制值	備註
  每個要求的事件數	每個要求 200 個事件	超過此限制會導致 BadRequest 錯誤。
  每個實體的事件數	每秒 8,000 個	超過此限制會導致 PerEntityEventRateLimitExceeded 錯誤。實體最常代表個別玩家，但也可以是玩家群組或遊戲。
  最大承載大小	10,240 位元組 (10 KB)
  如果您遇到上述任何限制，請聯絡 PlayFab 支援小組尋求協助。在 Game Manager 右上角選取問號圖示，然後選取 Contact Us。

​

我嘗試執行查詢時收到錯誤「Query execution has exceeded the allowed limits」

• 當結果集的大小或結果集中的資料列數超過允許的限制時，就會發生此錯誤。請嘗試使用 where、limit 或 summarize 運算子將查詢範圍限定於相關資料，以限制傳回的資料量
• 若要匯出所有資料，請在 PlayFab Game Manager 的 Title Overview 頁面上，瀏覽至 Data 下的 Event Export Tab。
• 如果您只想提取部分資料區段，或仍然達到查詢限制，可以依時間或唯一識別碼 (例如 Player ID、Title ID) 分割資料，並執行多個較小的查詢。以下是依時間分割的範例：

let start = datetime(2020-08-03);
let end = datetime(2020-08-07);
['events.all'] | where Timestamp between(start .. end)

['events.all'] | limit 1000

['events.all'] | summarize count() by FullName_Name, bin(Timestamp, 1d)

• 如需詳細資訊，請檢視 Kusto 文件。

​

我將 truncationmaxsize 和 truncationmaxrecords 變數設定為較大的值，但仍然收到錯誤

• PlayFab Insights 目前不支援設定這些變數。請參閱上方的查詢撰寫祕訣。

​

查詢 Insights 資料是否會阻止事件被擷取？

• 不會。PlayFab 事件會流入您遊戲的資料庫，不會有效能
• 損失。

​

我的查詢傳回「Partial query failure: Low memory condition」錯誤

• 這表示查詢太過複雜，無法符合您效能等級的記憶體限制。請嘗試簡化您的查詢。例如，summarize 呼叫可能有太多群組，或者您可能嘗試一次處理太多資料列。您也可以升級效能等級，讓每個查詢可配置更多記憶體。
• 如需詳細資訊，請檢視 Kusto 文件。

​

如果我的事件量高於效能等級所允許的量，我會遺失資料嗎？

• 不會，但您需要支付超額費用。超額是以消耗的 Insights Credits 數量來計算。Insights Credit 價格可在 PlayFab.com/Pricing 上找到。

​

如何決定效能等級？

• 最適合您的效能等級最好依據您遊戲的使用量來決定。提高效能等級可讓您在快取中存取更多資料及其他查詢資源，進而加快查詢執行速度。如需詳細資訊，請參閱效能等級與保留以深入了解效能等級。

​

如何授與使用者特定遊戲之 Data > Explorer 頁面的權限？

• 請依照 PlayFab 使用者角色指南來存取、建立和授與使用者權限。
• 使用者需要下列 3 個權限才能存取資料總管：
  • Explorer data & tab (讀取和寫入權限)
  • Analytics data read access (讀取權限)
  • Analytics data write access (寫入權限)