Skip to main content

app_profiles

Creates, updates, deletes, gets or lists a app_profiles resource.

Overview

Nameapp_profiles
TypeResource
Idgoogle.bigtableadmin.app_profiles

Fields

NameDatatypeDescription
namestringThe unique name of the app profile. Values are of the form projects/{project}/instances/{instance}/appProfiles/_a-zA-Z0-9*.
descriptionstringLong form description of the use case for this AppProfile.
dataBoostIsolationReadOnlyobjectData Boost is a serverless compute capability that lets you run high-throughput read jobs and queries on your Bigtable data, without impacting the performance of the clusters that handle your application traffic. Data Boost supports read-only use cases with single-cluster routing.
etagstringStrongly validated etag for optimistic concurrency control. Preserve the value returned from GetAppProfile when calling UpdateAppProfile to fail the request if there has been a modification in the mean time. The update_mask of the request need not include etag for this protection to apply. See Wikipedia and RFC 7232 for more details.
multiClusterRoutingUseAnyobjectRead/write requests are routed to the nearest cluster in the instance, and will fail over to the nearest cluster that is available in the event of transient errors or delays. Clusters in a region are considered equidistant. Choosing this option sacrifices read-your-writes consistency to improve availability.
prioritystringThis field has been deprecated in favor of standard_isolation.priority. If you set this field, standard_isolation.priority will be set instead. The priority of requests sent using this app profile.
singleClusterRoutingobjectUnconditionally routes all read/write requests to a specific cluster. This option preserves read-your-writes consistency but does not improve availability.
standardIsolationobjectStandard options for isolating this app profile's traffic from other use cases.

Methods

NameAccessible byRequired ParamsDescription
getSELECTappProfilesId, instancesId, projectsIdGets information about an app profile.
listSELECTinstancesId, projectsIdLists information about app profiles in an instance.
createINSERTinstancesId, projectsIdCreates an app profile within an instance.
deleteDELETEappProfilesId, instancesId, projectsIdDeletes an app profile from an instance.
patchUPDATEappProfilesId, instancesId, projectsIdUpdates an app profile within an instance.

SELECT examples

Lists information about app profiles in an instance.

SELECT
name,
description,
dataBoostIsolationReadOnly,
etag,
multiClusterRoutingUseAny,
priority,
singleClusterRouting,
standardIsolation
FROM google.bigtableadmin.app_profiles
WHERE instancesId = '{{ instancesId }}'
AND projectsId = '{{ projectsId }}';

INSERT example

Use the following StackQL query and manifest file to create a new app_profiles resource.

/*+ create */
INSERT INTO google.bigtableadmin.app_profiles (
instancesId,
projectsId,
name,
etag,
description,
multiClusterRoutingUseAny,
singleClusterRouting,
priority,
standardIsolation,
dataBoostIsolationReadOnly
)
SELECT
'{{ instancesId }}',
'{{ projectsId }}',
'{{ name }}',
'{{ etag }}',
'{{ description }}',
'{{ multiClusterRoutingUseAny }}',
'{{ singleClusterRouting }}',
'{{ priority }}',
'{{ standardIsolation }}',
'{{ dataBoostIsolationReadOnly }}'
;

UPDATE example

Updates a app_profiles resource.

/*+ update */
UPDATE google.bigtableadmin.app_profiles
SET
name = '{{ name }}',
etag = '{{ etag }}',
description = '{{ description }}',
multiClusterRoutingUseAny = '{{ multiClusterRoutingUseAny }}',
singleClusterRouting = '{{ singleClusterRouting }}',
priority = '{{ priority }}',
standardIsolation = '{{ standardIsolation }}',
dataBoostIsolationReadOnly = '{{ dataBoostIsolationReadOnly }}'
WHERE
appProfilesId = '{{ appProfilesId }}'
AND instancesId = '{{ instancesId }}'
AND projectsId = '{{ projectsId }}';

DELETE example

Deletes the specified app_profiles resource.

/*+ delete */
DELETE FROM google.bigtableadmin.app_profiles
WHERE appProfilesId = '{{ appProfilesId }}'
AND instancesId = '{{ instancesId }}'
AND projectsId = '{{ projectsId }}';