Configure SPICE memory capacity - Amazon Quick
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Configure SPICE memory capacity

SPICE (Super-fast, Parallel, In-memory Calculation Engine) is the robust in-memory engine that Amazon Quick uses. It's engineered to rapidly perform advanced calculations and serve data. In Enterprise edition, data stored in SPICE is encrypted at rest. For more information, see Data encryption in Quick.

SPICE capacity is allocated separately per Amazon Web Services Region. For each Amazon Web Services account, SPICE capacity is shared by all the people using Quick in a single Amazon Web Services Region. The other Amazon Web Services Regions have no SPICE capacity unless you choose to purchase some.

Quick administrators can view how much SPICE capacity you have in each Amazon Web Services Region and how much of it is currently in use. Administrators can also purchase additional SPICE capacity or release unused SPICE capacity. You can only release SPICE capacity that isn't currently used by a dataset. Datasets in SPICE stay there until someone remove them from SPICE. To change that, you can either delete the datasets or change them so they aren't stored in SPICE.

Purchasing or releasing SPICE capacity only affects the capacity for the currently selected Amazon Web Services Region. Each Amazon Web Services account can have a separate Amazon Quick subscription and can be used in multiple Amazon Web Services Regions.

Before you make any changes to SPICE capacity, make sure that you're using the correct Amazon Web Services account and Amazon Web Services Region. It's possible to be using different Amazon Web Services accounts or Amazon Web Services Regions at the same time in different contexts, as follows:

  • If you open Amazon Quick using the http://quicksight.aws.amazon.com URL, Amazon Quick automatically selects your account and Amazon Web Services Region. You can't view your Amazon Web Services account from Amazon Quick. We recommend using a different method to open Amazon Quick when you want to work with SPICE capacity.

  • If you open Amazon Quick from the Amazon Web Services Management Console, Amazon Quick opens in the account that you used to sign in to that console. However, it opens in the last Amazon Web Services Region that you selected in Amazon Quick. The Amazon Web Services Management Console and the Amazon Quick console each have an Amazon Web Services Region selector that works independently from the other. Changing the selected Amazon Web Services Region in the Amazon console doesn't change the Amazon Web Services Region in Amazon Quick.

  • If you use the Amazon Command Line Interface (Amazon CLI) to run Amazon Quick commands, make sure to provide the relevant Amazon Web Services account for each Amazon Quick API operation you use. The Amazon Web Services Region isn't always required, and if you don't provide it, the Amazon CLI uses your default Amazon Web Services Region from your Amazon configuration. We recommend that you always explicitly provide the Amazon Web Services Region, to make sure you apply the command to the correct Amazon Web Services Region.

You must be signed in as a Amazon Quick administrator to view or manage SPICE capacity.

Finding your current Amazon account and Amazon Web Services Region

To select the correct Amazon account and Amazon Web Services Region (console)
  1. Open the Amazon console, using the Amazon account that you want to view SPICE information for. If you have only one Amazon Web Services account, you can skip this step.

    You can verify the account number by following these steps:

    1. On the navigation bar at the top of the page, choose the account name or number at right. If a number displays, this might be your Amazon Web Services account ID.

    2. Choose My Security Credentials to display your credential-related information and options. Your Amazon Web Services account ID displays near the top of the page.

    To return to the original page, choose the Amazon logo at upper left.

  2. Open Amazon Quick by first entering "quicksight" into the Find Services search box. When the word Amazon Quick appears following the search box, choose it from the list.

  3. In Amazon Quick, open the profile menu by choosing your profile icon at top right. The Amazon name of the Amazon Web Services Region that Amazon Quick is using displays in the menu.

    The same Amazon Web Services Region also displays in the URL, for example: https://us-east-1.quicksight.aws.amazon.com/sn/admin. If this is your URL, the profile menu displays the name N. Virginia.

    To switch Amazon Web Services Regions, display the list of supported Regions by choosing the Region name from the profile menu. Then choose the Region that you want to use. Switching to a different Amazon Web Services Region changes the SPICE usage information that you can view. It also changes the Amazon Quick assets that you can use, for example data sources and dashboards.

Viewing SPICE capacity and usage in an Amazon Web Services Region

To view current SPICE capacity and usage (console)
  1. Open Amazon Quick. Make sure that you're using the correct Amazon Web Services account and Amazon Web Services Region as described previously in Finding your current Amazon account and Amazon Region.

  2. Open the administration page by choosing Manage Quick from your profile menu.

  3. Choose SPICE capacity from the left navigation pane . The following information displays:

    • The Total SPICE capacity section displays the total amount of used and unused SPICE capacity. A bar graph shows how much of this storage space is in each of the following categories for this Amazon Web Services account in the Amazon Web Services Region that's currently selected in Amazon Quick:

      • Purchased SPICE capacity – This is the additional SPICE capacity.

      • SPICE capacity bundled with Amazon Quick – This is the total default capacity associated with your paid users.

      Hover over any section of the meter to see details on that capacity type.

    • The SPICE usage section displays the total amount of the used and unused SPICE capacity. A bar graph shows how much of this storage space is in each of the following categories for this Amazon Web Services account in the Amazon Web Services Region that's currently selected in Amazon Quick:

      • Used SPICE capacity – This is the used portion of the default SPICE capacity that you get for each user.

      • Unused SPICE capacity – This is the unused portion of the default SPICE capacity that you get for each user.

      • Releasable unused capacity – This is the purchased capacity that isn't in use, and so can be released to reduce costs.

Hiding SPICE capacity labels

Amazon Quick account admins can choose to hide the account-wide SPICE capacity usage and remaining size labels from Amazon Quick authors. This feature is available to all enterprise accounts that use custom permissions. For more information about custom permissions in Amazon Quick, see Customizing access to Amazon Quick capabilities

Use the following procedure to hide SPICE capacity usage from the Amazon Quick console.

  1. Open the Quick console.

  2. From any page in the Amazon Quick console, choose your profile name, and then choose Manage Quick.

    The Manage Quick menu is only available to Amazon Quick admins. If you are unable to acces this menu, contact your Amazon Quick account admin for assistance.

  3. Choose Manage users, and then choose Manage permissions.

  4. Edit or create a new custom permission. For Restrict access to, under Datasets, select Viewing account SPICE capacity.

  5. When you are finished creating or changing the custom permission, chose Create or Update.

After you create or update a custom permission to hide SPICE capacity usage, assign the new permission to users with the UpdateUser API.

Purchasing SPICE capacity in an Amazon Web Services Region

To purchase more SPICE capacity (console)
  1. Open Amazon Quick. Make sure that you're using the correct Amazon Web Services account and Amazon Web Services Region as described previously in Finding your current Amazon account and Amazon Region.

  2. Open the administration page by choosing Manage Quick from your profile menu.

  3. Choose SPICE capacity from the left navigation pane .

  4. Choose the Purchase more capacity button.

  5. Enter a number of gigabytes of SPICE capacity to purchase for the Amazon Web Services Region that is currently selected in Amazon Quick.

  6. To confirm your choice, choose Purchase SPICE capacity. To exit without making any changes, choose Cancel.

Turning on SPICE auto capacity purchasing

Turn on SPICE auto capacity purchasing to allow Amazon Quick to automatically manage your Amazon Quick account's SPICE capacity. When you turn auto capacity purchasing on, Amazon Quick evaluates how much capacity is needed based on your account's usage. As your account uses more SPICE storage, Amazon Quick automatically purchases SPICE capacity as needed on your behalf. This allows users to ingest data as needed without the need to estimate usage or manually purchase SPICE data. Auto capacity purchasing makes it easier for new customers, ISVs, and larger companies to directly access SPICE without needing to understand, track, or manually purchase their account's SPICE capacity. Amazon Quick admins can still purchase and release SPICE capacity manually.

Auto capacity purchasing doesn't support auto-decrement. If users want to reduce their SPICE usage, capacity release must be done manually.

By default, all new Amazon Quick accounts that are created in the Amazon Quick console have auto capacity purchasing turned on in the region that their capacity is located. To turn on auto capacity purchasing for other regions, Amazon Quick account admins can manually turn on auto capacity from the SPICE capacity management page.

By default, all new Amazon Quick accounts that were created with the Amazon Quick API and all existing Amazon Quick accounts have auto capacity purchasing turned off. To turn on auto capacity purchasing, Amazon Quick account admins can manually turn on auto capacity from the SPICE capacity management page.

To turn SPICE capacity purchasing on or off
  1. Open the Quick console.

  2. From any page in the Amazon Quick console, choose your profile name, and then choose Manage Quick.

    The Manage Quick menu is only available to Amazon Quick admins. If you are unable to acces this menu, contact your Amazon Quick account admin for assistance.

  3. Choose SPICE capacity.

  4. On the SPICE Capacity page that opens, toggle the Auto-purchase capacity on.

To turn auto capacity purchasing off, follow the procedure above and toggle Auto-purchase capacity off. When auto purchase capacity is turned off, ingestions or refreshes that exceed the account's SPICE capacity automatically fail.

Amazon Quick admins can turn auto capacity pricing on or off at any time. If you turn auto capacity purchasing off after it's been in use, your account's current capacity becomes your account's purchased capacity. If your account has no remaining capacity when you turn auto purchase off, the next ingestion or refresh will fail.

If your account already exceeds its SPICE capacity when you turn auto capacity purchasing on, Amazon Quick automatically matches your account's capacity to your current usage. After Amazon Quick matches your account's capacity, the auto-purchase logic starts.

Releasing SPICE capacity in an Amazon Web Services Region

To release unused SPICE capacity (console)
  1. Open Amazon Quick. Make sure that you're using the correct Amazon Web Services account and Amazon Web Services Region as described previously in Finding your current Amazon account and Amazon Region.

  2. Open the administration page by choosing Manage Quick from your profile menu.

  3. Choose SPICE capacity from the left navigation pane .

  4. Choose Release unused purchased capacity.

  5. Do one of the following:

    • To release all SPICE capacity from the Amazon Web Services Region that is currently selected in Amazon Quick, choose Release all.

    • To release some of gigabytes of SPICE capacity from the Amazon Web Services Region that is currently selected in Amazon Quick, enter the number of gigabytes to release.

  6. To confirm your choice, choose Release SPICE capacity. To exit without making any changes, choose Cancel.