cloudsql

package
v1.7.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 25, 2026 License: MIT Imports: 9 Imported by: 0

Documentation

Overview

Package cloudsql provides an in-memory mock of GCP Cloud SQL. It implements relationaldb/driver.RelationalDB so the same backend serves both the portable API (relationaldb.DB) and the SDK-compat HTTP layer.

Cloud SQL has no Aurora-style cluster concept — the cluster methods on the driver interface return InvalidArgument. Instances and snapshots (a.k.a. "backup runs" in Cloud SQL terminology) are fully supported, as is restore-from-backup.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Mock

type Mock struct {
	// contains filtered or unexported fields
}

Mock is the in-memory GCP Cloud SQL implementation.

func New

func New(opts *config.Options) *Mock

New creates a new Cloud SQL mock.

func (*Mock) CreateCluster

func (*Mock) CreateCluster(_ context.Context, _ rdsdriver.ClusterConfig) (*rdsdriver.Cluster, error)

CreateCluster is unsupported on Cloud SQL — it has no Aurora-style cluster.

func (*Mock) CreateClusterSnapshot

func (*Mock) CreateClusterSnapshot(
	_ context.Context, _ rdsdriver.ClusterSnapshotConfig,
) (*rdsdriver.ClusterSnapshot, error)

CreateClusterSnapshot is unsupported on Cloud SQL.

func (*Mock) CreateInstance

func (m *Mock) CreateInstance(_ context.Context, cfg rdsdriver.InstanceConfig) (*rdsdriver.Instance, error)

CreateInstance creates a new Cloud SQL instance.

func (*Mock) CreateSnapshot

func (m *Mock) CreateSnapshot(_ context.Context, cfg rdsdriver.SnapshotConfig) (*rdsdriver.Snapshot, error)

CreateSnapshot creates a backup run for an instance. Cloud SQL calls these "backup runs"; the portable API exposes them as snapshots.

func (*Mock) DeleteCluster

func (*Mock) DeleteCluster(_ context.Context, _ string) error

DeleteCluster is unsupported on Cloud SQL.

func (*Mock) DeleteClusterSnapshot

func (*Mock) DeleteClusterSnapshot(_ context.Context, _ string) error

DeleteClusterSnapshot is unsupported on Cloud SQL.

func (*Mock) DeleteInstance

func (m *Mock) DeleteInstance(_ context.Context, id string) error

DeleteInstance removes an instance.

func (*Mock) DeleteSnapshot

func (m *Mock) DeleteSnapshot(_ context.Context, id string) error

DeleteSnapshot removes a backup run.

func (*Mock) DescribeClusterSnapshots

func (*Mock) DescribeClusterSnapshots(
	_ context.Context, _ []string, _ string,
) ([]rdsdriver.ClusterSnapshot, error)

DescribeClusterSnapshots returns an empty list — Cloud SQL has no clusters.

func (*Mock) DescribeClusters

func (*Mock) DescribeClusters(_ context.Context, _ []string) ([]rdsdriver.Cluster, error)

DescribeClusters returns an empty list — Cloud SQL has no clusters.

func (*Mock) DescribeInstances

func (m *Mock) DescribeInstances(_ context.Context, ids []string) ([]rdsdriver.Instance, error)

DescribeInstances returns all instances if ids is empty, else only matching ones.

func (*Mock) DescribeSnapshots

func (m *Mock) DescribeSnapshots(
	_ context.Context, ids []string, instanceID string,
) ([]rdsdriver.Snapshot, error)

DescribeSnapshots returns snapshots filtered by ids and/or instance.

func (*Mock) ModifyCluster

ModifyCluster is unsupported on Cloud SQL.

func (*Mock) ModifyInstance

func (m *Mock) ModifyInstance(
	_ context.Context, id string, input rdsdriver.ModifyInstanceInput,
) (*rdsdriver.Instance, error)

ModifyInstance applies the supplied changes.

func (*Mock) RebootInstance

func (m *Mock) RebootInstance(_ context.Context, id string) error

RebootInstance cycles an instance through rebooting. In Cloud SQL this corresponds to the :restart endpoint.

func (*Mock) RestoreClusterFromSnapshot

func (*Mock) RestoreClusterFromSnapshot(
	_ context.Context, _ rdsdriver.RestoreClusterInput,
) (*rdsdriver.Cluster, error)

RestoreClusterFromSnapshot is unsupported on Cloud SQL.

func (*Mock) RestoreInstanceFromSnapshot

func (m *Mock) RestoreInstanceFromSnapshot(
	_ context.Context, input rdsdriver.RestoreInstanceInput,
) (*rdsdriver.Instance, error)

RestoreInstanceFromSnapshot creates a new instance from a backup run.

func (*Mock) SetMonitoring

func (m *Mock) SetMonitoring(mon mondriver.Monitoring)

SetMonitoring wires a Cloud Monitoring backend for auto-metric emission.

func (*Mock) StartCluster

func (*Mock) StartCluster(_ context.Context, _ string) error

StartCluster is unsupported on Cloud SQL.

func (*Mock) StartInstance

func (m *Mock) StartInstance(_ context.Context, id string) error

StartInstance moves a stopped instance back to runnable. In Cloud SQL this corresponds to setting settings.activationPolicy=ALWAYS.

func (*Mock) StopCluster

func (*Mock) StopCluster(_ context.Context, _ string) error

StopCluster is unsupported on Cloud SQL.

func (*Mock) StopInstance

func (m *Mock) StopInstance(_ context.Context, id string) error

StopInstance moves a runnable instance to stopped. In Cloud SQL this corresponds to setting settings.activationPolicy=NEVER.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL