IBM Cloud Docs
watsonx.data enterprise plan

watsonx.data enterprise plan

IBM® watsonx.data is a data management solution for collecting, storing, querying, and analyzing all your enterprise data with a single unified data platform. It provides a flexible and reliable platform that is optimized to work on open data formats. This tutorial is a short introduction to using a watsonx.data deployment.

For more information about the developer edition of watsonx.data and watsonx.data on Red Hat OpenShift, see IBM® watsonx.data.

For more information about using watsonx.data on IBM Software Hub. For more information, see IBM® watsonx.data on IBM Software Hub.

Before you begin

You need to have a paid IBM Cloud account.

The access to provision IBM Cloud resources is governed by using IAM access and account management services. You must have Administrator privileges to provision a watsonx.data instance.

Provision an instance

Provision an instance through UI

  1. Go to the IBM Cloud catalog page.

  2. Find the watsonx.data tile and click it. You are redirected to the provisioning page.

  3. Select the cloud platform (IBM Cloud or Amazon Web Services) you want to deploy watsonx.data.

  4. Select the pricing plan as Enterprise from the Select a pricing plan options.

  5. Select a location from the list of available locations for watsonx.data service.

  6. Enter the service name. It can be any string and is used in the web console to identify the new deployment.

  7. Select a resource group. If you are organizing your services into resource groups, specify the resource group.

  8. Enter a tag name.

  9. Enter the access management tags.

  10. Click Create.

    After you click Create, the system displays a message to say that the instance is being provisioned, which returns you to the Resource list. From the Resource list, under Databases category, you see that the status for your instance is, Provision in progress.

  11. When the status changes to Active, select the instance.

Provisioning an instance through Terraform module

You can provision an instance by using a pre-built, open-source, enterprise-ready Terraform module. This method uses Terraform IBM Modules (TIM), which are curated collections of Terraform modules that simplify creating, managing, and versioning complex, compliant environments on IBM Cloud.

About the watsonx.data Terraform module

The watsonx.data module is a purpose-built Terraform module that follows secure-by-default principles and aligns with IBM Cloud best practices. The module provides the following capabilities:

  • Standardized method for creating and working with IBM watsonx.data instances
  • Comprehensive documentation with README files and examples
  • Multiple deployment scenarios through basic, advanced, and existing instance examples
  • Controlled versioning for safe updates and easier dependency management
  • Enterprise-ready configurations that are secure, scalable, and compliant

Deploying the module

To deploy the watsonx.data enterprise plan by using this Terraform module, complete the steps in Deploying a Terraform IBM Module by using Terraform CLI.

The deployment process includes the following steps:

  1. Verify that you have the required prerequisites: Terraform CLI and IBM Cloud API key.
  2. Create the Terraform configuration based on the code and examples provided.
  3. Configure input variables for your deployment.
  4. Run terraform init to download required providers and modules.
  5. Run terraform plan to preview the changes that Terraform will make to your infrastructure.
  6. Run terraform apply to provision your watsonx.data instance.

Provision an instance through CLI

  1. Log in to cloud.ibm.com.

    ibmcloud login --sso -a https://cloud.ibm.com

  2. Select an account on which you want to create an instance.

  3. Create a new formation.

    ibmcloud resource service-instance-create <instance-name> lakehouse <plan-id> <region> -g <resource-group> -p '{"datacenter": "<data-center>","cloud_type": "<cloud-type>"}'
    • instance-name: Name of the instance. For example, watsonx.data-abc.
    • lakehouse: watsonx.data service
    • plan-id : The plan-id is lakehouse-enterprise for regions eu-de, us-east, us-south, jp-tok, and eu-gb. It must be lakehouse-enterprise-mcsp for au-syd, ca-tor regions.
    • region: The available regions are eu-de, us-east, us-south, jp-tok, eu-gb, au-syd, and ca-tor.
    • resource-group: Choose one of the available resource groups in your IBM Cloud account. Most accounts have a Default group. For more information, see Managing resource groups.
    • datacenter: Use one of the following. This parameter must match the region that you have selected.
      • ibm:us-south:dal
      • ibm:us-east:wdc
      • ibm:eu-de:fra
      • ibm:eu-gb:lon
      • ibm:au-syd:syd
      • ibm:ca-tor:tor
      • ibm:jp-tok:tok
    • cloud_type:

      • ibm: For fully managed account instances (default).

      • aws_vpc: For customer-owned account instances.

        For availability and general information related to customer-owned account deployed instances, contact your IBM sales representative or open a support ticket.

    Example 1 : Provision an enterprise plan in us-south region.

    ibmcloud resource service-instance-create watsonx.data-abc lakehouse lakehouse-enterprise us-south -g Default -p '{"datacenter": "ibm:us-south:dal","cloud_type": "ibm"}'

    Example 2 : Provision an enterprise plan in Sydney region.

    ibmcloud resource service-instance-create <instance-name> lakehouse lakehouse-enterprise-mcsp au-syd -g Default -p '{"datacenter": "ibm:au-syd:syd"}'

  4. Check the status of the new instance.

    ibmcloud resource service-instance <instance-name>

Provisioning Virtual Private Endpoint (VPE) enabled instance

You can provision an IBM watsonx.data instance with VPE enabled to connect your IBM watsonx.data instance privately and securely to resources in your Virtual Private Cloud (VPC), eliminating exposure to the public internet. This configuration is supported in the following regions:

  • Dallas (us-south)
  • Washington DC (us-east)
  • Frankfurt (eu-de)
  • Sydney (au-syd)
  • Toronto (ca-tor)

Currently, enabling VPE during provisioning requires adding the vpe_required parameter only for Dallas, Washington DC, and Frankfurt. Other regions such as Toronto and Sydney do not require this parameter. This is a temporary behavior and will be standardized in a future release.

Examples:

Region: Dallas

ibmcloud resource service-instance-create <instance_name> lakehouse lakehouse-enterprise us-south -g Default -p '{"cloud_type": "ibm", "region": "us-south", "datacenter": "ibm:us-south:dal", "vpe_required":"true"}'

Region: Frankfurt

ibmcloud resource service-instance-create <instance-name> lakehouse lakehouse-enterprise eu-de -g Default -p '{"cloud_type": "ibm", "region": "eu-de", "datacenter": "ibm:eu-de:fra", "vpe_required":"true"}'

Region: Washington DC

ibmcloud resource service-instance-create <instance_name> lakehouse lakehouse-enterprise us-east -g Default -p '{"cloud_type": "ibm", "region": "us-east", "datacenter": "ibm:us-east:wdc", "vpe_required":"true"}'
  • instance-name: Name of the instance. For example, watsonx.data-abc.
  • lakehouse: watsonx.data service
  • plan-id : The plan-id is lakehouse-enterprise for regions eu-de, us-east, us-south, au-syd, and ca-torregions.
  • region: The available regions are eu-de, us-east, us-south, au-syd, and ca-tor.
  • datacenter: Use one of the following. This parameter must match the region that you have selected.
    • ibm:us-south:dal
    • ibm:us-east:wdc
    • ibm:eu-de:fra
    • ibm:au-syd:syd
    • ibm:ca-tor:tor
  • cloud_type:
    • ibm: For fully managed account instances (default).
    • vpe_required: This parameter must be set to True for eu-de, us-east, us-south. Toronto and Sydney do not require this parameter.

Open the web console

  1. Go to Resource list > Databases.

  2. Click your watsonx.data instance link. The service instance page opens.

  3. If you provisioned watsonx.data Enterprise in the ca-tor region, you have two options. Click Open Admin console to launch watsonx.data web console experience. You must complete the quick start steps, see Quick start watsonx.data console.

Click watsonx to launch the watsonx.data experience on the watsonx platform and work with unstructured data. See the IBM watsonx.data as a Service documentation.

Next steps

To quickly get started with the watsonx.data web console by configuring the infrastructure components, see Quick start watsonx.data console.

After you complete quick start, Resource unit consumption is accounted and billing is started. If no Resource Units are consumed within seven (7) days after an instance creation, the unused instance is deleted, after which a new instance can be re-created. For more information, see Provisioning an instance.