[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-17。"],[[["\u003cp\u003eThe BigQuery slot recommender analyzes historical slot usage to provide cost-optimized recommendations for edition commitment slots and autoscaling slots, maintaining similar query performance.\u003c/p\u003e\n"],["\u003cp\u003eRecommendations are available for both reservations billing (Enterprise or Enterprise Plus editions) and on-demand billing, including cost-optimized options for organization-wide, project-specific, or project group workloads.\u003c/p\u003e\n"],["\u003cp\u003eThe recommender offers different pricing types (pay as you go, 1-year, and 3-year commitments) and calculates the total monthly cost for each option, including baseline commitment and autoscale slots.\u003c/p\u003e\n"],["\u003cp\u003eFor performance improvement, the slot recommender suggests a maximum reservation size that can enhance job performance by at least 5%, based on historical slot modeling data.\u003c/p\u003e\n"],["\u003cp\u003eSpecific IAM permissions are required to view and apply recommendations, including \u003ccode\u003erecommender.bigqueryCapacityCommitmentsRecommendations.get\u003c/code\u003e and \u003ccode\u003ebilling.accounts.getPricing\u003c/code\u003e, with varying levels of access needed for organization, project, or billing account scopes.\u003c/p\u003e\n"]]],[],null,["# View edition slot recommendations\n=================================\n\nThe BigQuery slot recommender creates recommendations for\n[edition](/bigquery/docs/editions-intro) or on-demand workloads. The recommender\nanalyzes historical slot usage for query jobs and calculates the cost-optimal\nsettings for edition commitment slots and\n[autoscaling](/bigquery/docs/slots-autoscaling-intro) slots while maintaining\nsimilar performance. The slot recommender can also recommend a maximum\nreservation size that can improve performance.\n\nYou can use the slot recommender for both reservations billing and on-demand\nbilling:\n\n- For reservations billing, you can get a cost-optimized recommendation for Enterprise or Enterprise Plus edition workloads and performance-based recommendations for your reservations.\n- For on-demand billing, you can get cost-optimized recommendations for on-demand workloads across the organization, for a specific project, or a group of projects if you were to convert one or more projects to the Enterprise edition.\n\nFor more information about the recommender service, see the\n[Recommender overview](/recommender/docs/overview).\n\nCost-optimized recommendations\n------------------------------\n\nThe slot recommender estimates your autoscaling usage based on slot usage over\nthe past 30 days. For more information about slots autoscaling, see\n[Introduction to slots autoscaling](/bigquery/docs/slots-autoscaling-intro).\nThe recommender can generate multiple commitment options and calculate the\ntotal cost for each option. The recommender can also recommend options with the\nlowest total cost by using custom pricing. The recommended commitment and\nautoscale slots are meant to cover P99 slot usage of the entire 30-day\nobservation window.\n\nThe slot recommender offers recommendations for different pricing types,\nincluding pay as you go (no commitments), 1-year and 3-year commitments. It\ndisplays the monthly cost for each option based on custom pricing.\n\nThe recommendation includes the following details:\n\n- Baseline commitment slots: The number of commitment slots to achieve optimal cost without affecting performance. You can also view the optimal commitments in the usage chart above by selecting **View optimal\n commitments**.\n- Baseline commitment monthly cost: The monthly cost of the optimal commitment slots, calculated using the custom edition commitment price. A month is defined as 730 hours.\n- Autoscale slots: The maximum number of autoscale slots used at a time. This represents the additional slots beyond the optimal commitment slots that are covered by autoscaling. This value does not include the commitment or baseline slots.\n- Expected autoscale utilization: The expected monthly utilization of autoscale slots, calculated as the expected autoscale slots used divided by the maximum autoscale slots.\n- Autoscale monthly cost: The monthly cost of using the expected amount of autoscale slots, calculated using the custom autoscale price.\n- Total monthly cost: The total monthly cost, which includes the commitment monthly cost and the autoscale monthly cost.\n\n### Best practices when applying recommendations\n\n| **Note:** The recommendations provided are based on historical data, and the actual results may vary depending on the specific characteristics of your workloads.\n\n1. Ensure that the sum of baseline slots for all reservations under the edition is equal or less than the commitment slots. This ensures that any slot usage exceeding the commitment slots can be covered by autoscale slots. If the baseline slots exceed the commitment slots, you are billed for additional baseline slots.\n2. Autoscale slots in the settings is chosen so that available capacity matches the peak historical usage. This is to ensure the performance is not impacted. You can also adjust the autoscale slots to a value lower than the maximum, which can increase autoscale utilization. However, please note that when your slot usage cannot be fully covered, it may affect query performance.\n3. In circumstances where your workload experiences spikes and temporarily exceeds its maximum capacity, the slot recommender mechanism can overestimate its recommendations. In such situations, you may consider maintaining the current settings, assuming that you are satisfied with the current level of performance.\n\n### Required permissions\n\nTo view cost-optimal commitment slots recommendations, you need the following\nIdentity and Access Management (IAM) permissions:\n\n- `recommender.bigqueryCapacityCommitmentsRecommendations.get`\n- `recommender.bigqueryCapacityCommitmentsRecommendations.list`\n\nEach of the following predefined IAM roles includes these\npermissions:\n\n- `BigQuery Resource Admin`\n- `BigQuery Slot Recommender Viewer`\n- `BigQuery Slot Recommender Admin`\n\nTo view recommendations for your edition workloads, you must have the listed\npermission for the administration project.\n\nTo view project level recommendations for your on-demand workloads, you must\nhave the previously listed permissions at the project level.\n\nTo view cost-optimized recommendations for on-demand workloads for a group of\nprojects, you must have the previously listed permissions at the organization\nlevel and either `bigquery.jobs.listExecutionMetadata` or\n`bigquery.jobs.listAll` permission.\n\nTo view organization level recommendations for your on-demand workloads, you\nmust have the previously listed permissions at the organization level. You also\nneed the `resourcemanager.organizations.get` permission. The `Organization\nViewer` IAM role includes this permission.\n\nIn the recommendations settings, rows such as\n**Baseline commitment slots** and **Total monthly cost** are visible, but\nthe values of the monthly cost details are hidden. To view the hidden values,\nyou also need the following permission:\n\n- `billing.accounts.getPricing`\n\nEach of the following predefined IAM roles includes these\npermissions:\n\n- `Billing Account Viewer`\n- `Billing Account Administrator`\n\nFor edition workloads, you need the permissions listed above at the billing\naccount associated with the administrator project. For project level on-demand\nworkloads, you need the permissions at the billing account associated with the\nproject or at the organization level for organization level recommendations.\n\nFor more information about IAM roles in BigQuery,\nsee [Predefined roles and permissions](/bigquery/docs/access-control).\n\nPerformance-improving recommendation\n------------------------------------\n\nWhen you select a specific reservation workload, the slot recommender suggests\nthe maximum reservation size that can enhance job performance. The slot\nestimator then analyzes the\n[slot modeling](/bigquery/docs/slot-estimator#model_slot_performance) data and\nfinds the minimum incremental value for the maximum reservation size that is\ncapable of elevating job performance by at least 5%. If your current maximum\nreservation size meets your historical needs, then no recommendation is made.\n\n| **Note:** Recommendation are based on historical data. Job performance can vary based on actual use.\n\nTo implement a recommendation, click **Apply** to be redirected to the page\nwhere you can update the reservation.\n\nBefore you begin\n----------------\n\nBefore you can view the recommendations, you must [enable the Recommender\nAPI](/recommender/docs/enabling). To view the recommendations within the\nGoogle Cloud console, you must also [enable the Reservations\nAPI](/bigquery/docs/reservations-commitments#enabling-reservations-api).\n\n### Required permissions\n\nThe slot recommender for reservations performance improvement recommendations\nrequires that you have the following IAM permissions on the\nadministration project:\n\n- `bigquery.reservations.list`\n- `bigquery.reservationAssignments.list`\n- `bigquery.capacityCommitments.list`\n\nTo apply the recommended updates to the reservation, you must also have the\nfollowing IAM permissions on the administration project:\n\n- `bigquery.reservations.update`\n\nFor more information about IAM roles in BigQuery,\nsee [Predefined roles and permissions](/bigquery/docs/access-control).\n\nPricing\n-------\n\nThis recommender is displayed within the context of [slot estimator](/bigquery/docs/slot-estimator). You can use the recommendations at no charge.\n\nView slot recommendations\n-------------------------\n\nTo view slot recommendations using the Google Cloud console, perform the following\nsteps.\n\n1. In the Google Cloud console, go to the BigQuery page.\n\n [Go to BigQuery](https://console.cloud.google.com/bigquery)\n2. For edition workloads recommendations, select the administrator project. For\n on-demand workloads recommendations, select any project within your\n organization that meets the predefined requirements.\n\n3. For on-demand workloads, if you have organization level permissions, you can\n select any individual project or the entire organization in the side panel\n options to view recommendations for the specific scope.\n\n4. In the navigation menu, click **Capacity management**.\n\n5. Click the **Slot estimator** tab.\n\n6. In the **Source** pane, select an on-demand workload or an\n edition (Enterprise or Enterprise Plus) workload.\n\n - If you select an edition workload, detailed recommendations appear under the graph of historical usage.\n - If you select an on-demand workload, the organization administrator is able to switch between organization level and project level (for one or more projects)."]]