Note: This documentation applies to the Standard, Plus, and Frontline editions of Gemini Enterprise. For information about the Business edition, see the Gemini Enterprise - Business edition Help Center .

Create a data store using Terraform

You can use Terraform to create a generic Gemini Enterprise data store or to set up data connectors for Atlassian Confluence, Atlassian Jira, BigQuery, Microsoft SharePoint, or Salesforce.

Before you begin

Before using Terraform to create a data store, do the following:

Check whether billing is enabled on your Google Cloud project .
Ensure that you have the Project IAM Admin ( roles/resourcemanager.projectIamAdmin ) role for your Google Cloud project, as well as the Discovery Engine Admin ( roles/discoveryengine.admin ) role.
Optional: If you are connecting a third-party data source like Microsoft SharePoint to Gemini Enterprise, obtain access credentials (such as API keys or database authentication) for the data source.

Ensure that you are using version 7.7.0 or later of the hashicorp/google Terraform provider:

 terraform {
  required_providers {
    google = {
      source  = "hashicorp/google"
      version = "7.7.0"
    }
  }
}

Create a generic data store

To use Terraform to create an empty data store, use the google_discovery_engine_data_store Terraform resource.

Create the Terraform configuration:

 terraform {
  required_providers {
    google = {
      source  = "hashicorp/google"
      version = "7.7.0"
    }
  }
}

provider "google" {
  project                 = " PROJECT_ID 
"
  user_project_override   = true
  billing_project         = " BILLING_PROJECT_ID 
"
}

resource "google_discovery_engine_data_store" "gemini_search_store" {
  location                    = " LOCATION 
"
  data_store_id               = " DATA_STORE_ID 
"
  display_name                = " DATA_STORE_NAME 
"
  industry_vertical           = "GENERIC"
  content_config              = "NO_CONTENT"
  solution_types              = ["SOLUTION_TYPE_SEARCH"]
  create_advanced_site_search = false
}

Replace the following:

PROJECT_ID : your Google Cloud project ID
BILLING_PROJECT_ID : your Google Cloud billing project ID
LOCATION : the location for the data store, such as us or global (for more information, see Gemini Enterprise Standard and Plus Editions data residency and ML regional processing commitments )
DATA_STORE_ID : the data store ID
DATA_STORE_NAME : the data store name

Initialize Terraform:
```
 terraform  
init  
-upgrade 
```
Preview your configuration:
```
 terraform  
plan 
```
Apply the configuration:
```
 terraform  
apply 
```

After creating the empty data store, you can ingest data into the data store using the Google Cloud console or API commands.

Create a data connector

To use Terraform to create a data connector for a supported service, use the google_discovery_engine_data_connector Terraform resource. Include credentials for the service, as well as search filter configuration, in json_params .

Create the Terraform configuration:
```
 terraform {
  required_providers {
    google = {
      source  = "hashicorp/google"
      version = "7.7.0"
    }
  }
}

provider "google" {
  project                 = " PROJECT_ID 
"
  user_project_override   = true
  billing_project         = " BILLING_PROJECT_ID 
"
}

resource "google_discovery_engine_data_connector" " LOCAL_NAME 
" {
  provider = google

  project                 = " PROJECT_ID 
"
  location                = " LOCATION 
"
  collection_id           = " COLLECTION_ID 
"
  collection_display_name = " COLLECTION_DISPLAY_NAME 
"

  data_source = " DATA_SOURCE 
"

  json_params = jsonencode({
    "client_id"                = " CLIENT_ID 
"
    "client_secret"            = " CLIENT_SECRET 
"
    "instance_uri"             = " INSTANCE_URI 
"
    "tenant_id"                = " TENANT_ID 
"
    "structured_search_filter" = { " FILTER_KEY 
" = [" FILTER_VALUE 
"] }
  })

  refresh_interval = "7200s"

  connector_modes = [ CONNECTOR_MODES 
]

  entities {
    entity_name = " ENTITY_NAME 
"
  }
} 
```
Replace the following:
- PROJECT_ID : your Google Cloud project ID
- BILLING_PROJECT_ID : your Google Cloud billing project ID
- LOCAL_NAME : the local name of the Terraform resource
- LOCATION : the location for the data store, such as us or global (for more information, see Gemini Enterprise Standard and Plus Editions data residency and ML regional processing commitments )
- COLLECTION_ID : the collection ID
- COLLECTION_DISPLAY_NAME : the collection display name
- DATA_SOURCE : the data source type. The following values are supported:
  - bigquery
  - confluence
  - jira
  - salesforce
  - sharepoint_federated_search
- CLIENT_ID : the client ID for the service
- CLIENT_SECRET : the client secret for the service
- INSTANCE_URI : the URI of your instance (for example, https://your-tenant.sharepoint.com )
- TENANT_ID : the tenant ID
- FILTER_KEY : a filter key (for example, Path )
- FILTER_VALUE : a filter value (for example, "https://example.sharepoint.com/*" )
- ENTITY_NAME : the name of an entity for the connector to search (see the resource documentation )
- CONNECTOR_MODES : the modes to enable for the connector (for example, "FEDERATED" )
Initialize Terraform:
```
 terraform  
init  
-upgrade 
```
Preview your configuration:
```
 terraform  
plan 
```
Apply the configuration:
```
 terraform  
apply 
```
When prompted, confirm your changes.

After applying the configuration, you can see the data connector in the list of data stores and can connect it to a Gemini Enterprise app. For more information, see Connect a data store to app and authorize Gemini Enterprise .

Update a data connector

To use Terraform to update settings for an existing data connector, provide the new settings in json_params , and provide any unchanged arguments with their current values so that Terraform doesn't replace the resource. Add any required arguments that don't need to be updated to ignore_changes in the lifecycle block.

Create the Terraform configuration. This example updates the structured_search_filter setting with a new filter value, but lists other required fields such as refresh_interval , entities , and connector_modes with their current values.
```
 terraform {
  required_providers {
    google = {
      source  = "hashicorp/google"
      version = "7.7.0"
    }
  }
}

provider "google" {
  project               = " PROJECT_ID 
"
  user_project_override = true
  billing_project       = " BILLING_PROJECT_ID 
"
}

resource "google_discovery_engine_data_connector" " LOCAL_NAME 
" {
  provider = google

  project                 = " PROJECT_ID 
"
  location                = " LOCATION 
"
  collection_id           = " COLLECTION_ID 
"
  collection_display_name = " COLLECTION_DISPLAY_NAME 
"

  data_source = " DATA_SOURCE 
"

  json_params = jsonencode({
    "structured_search_filter" = { " FILTER_KEY 
" = [" UPDATED_FILTER_VALUE 
"] }
  })
  refresh_interval = " REFRESH_INTERVAL 
"

  entities {
    entity_name           = " ENTITY_NAME 
"
    key_property_mappings = {}
  }
  static_ip_enabled = false
  connector_modes   = [ CONNECTOR_MODES 
]

  lifecycle {
    ignore_changes = [
      collection_display_name,
      entities,
      refresh_interval
    ]
  }
} 
```
Replace the following:
- PROJECT_ID : your Google Cloud project ID
- BILLING_PROJECT_ID : your Google Cloud billing project ID
- LOCAL_NAME : the local name of the Terraform resource
- LOCATION : the location for the data store, such as us or global (for more information, see Gemini Enterprise Standard and Plus Editions data residency and ML regional processing commitments )
- COLLECTION_ID : the collection ID
- COLLECTION_DISPLAY_NAME : the collection display name
- DATA_SOURCE : the data source type. The following values are supported:
  - bigquery
  - confluence
  - jira
  - salesforce
  - sharepoint_federated_search
- FILTER_KEY : a filter key for which you want to update the value (for example, Path )
- UPDATED_FILTER_VALUE : the new filter value (for example, https://other.sharepoint.com/* )
- REFRESH_INTERVAL : the refresh interval
- ENTITY_NAME : the name of an entity for the connector to search (see the resource documentation )
- CONNECTOR_MODES : the modes to enable for the connector (for example, "FEDERATED" )

Run terraform import to indicate that this is an update operation:

 terraform  
import  
 \ 
google_discovery_engine_data_connector. LOCAL_NAME 
  
 \ 
projects/ PROJECT_ID 
/locations/ LOCATION 
/collections/ COLLECTION_ID 
/dataConnector

Preview your configuration:

 terraform  
plan

The output should be similar to the following:

 Terraform  
used  
the  
selected  
providers  
to  
generate  
the  
following  
execution  
plan.  
Resource  
actions  
are  
indicated  
with  
the  
following  
symbols:  
~  
update  
 in 
-place

Terraform  
will  
perform  
the  
following  
actions:  
google_discovery_engine_data_connector.update-sharepoint-connector  
will  
be  
updated  
 in 
-place  
~  
resource  
 "google_discovery_engine_data_connector" 
  
 "update-sharepoint-connector" 
  
 { 
  
 id 
  
 = 
  
 "projects/my-project-123/locations/global/collections/default_collection/dataConnector" 
  
~  
 json_params 
  
 = 
  
jsonencode ( 
  
~  
 { 
  
~  
 structured_search_filter 
  
 = 
  
 { 
  
~  
 "Path" 
  
 = 
  
 [ 
  
~  
 "https://other.sharepoint.com/*" 
  
-  
 "https://example.sharepoint.com/*" 
,  
 ( 
 1 
  
unchanged  
element  
hidden ) 
  
 ] 
  
 } 
  
 } 
  
 ) 
  
 name 
  
 = 
  
 "projects/my-project-123/locations/global/collections/default_collection/dataConnector" 
  
 ( 
 21 
  
unchanged  
attributes  
hidden ) 
  
 ( 
 2 
  
unchanged  
blocks  
hidden ) 
  
 } 
Plan:  
 0 
  
to  
add,  
 1 
  
to  
change,  
 0 
  
to  
destroy.

Ensure that the final line of output specifies 0 to add, 1 to change, 0 to destroy .

Apply the configuration:

 terraform  
apply

When prompted, confirm your changes.