Meta tags:
description=Learn how to connect to Cloud SQL from a local test environment using the Cloud SQL Auth Proxy.;

Headings (most frequently used words):

cloud, sql, the, bit, auth, proxy, 64, for, instance, linux, 32, windows, roles, connect, to, mysql, using, before, you, begin, create, install, client, get, connection, name, start, clean, up, what, next, console, gcloud, macos, mac, m1, docker, image, other, os, optional, cleanup, steps, products, and, pricing, support, resources, engage, check, grant,

Text of the page (most frequently used words):
the (167), cloud (160), sql (124), and (69), proxy (62), for (45), you (45), instance (43), #connect (43), using (39), auth (36), project (36), create (34), google (32), use (32), from (32), manage (26), with (25), instances (25), your (24), mysql (24), database (20), overview (19), about (18), this (18), page (18), select (16), quickstart (16), click (15), console (14), that (14), can (14), roles (14), data (14), configure (13), resources (12), see (12), download (12), storage (12), server (12), role (12), access (12), iam (12), upgrade (12), connection (11), command (11), connectors (10), bit (10), private (10), more (9), apis (9), name (9), following (9), import (9), engine (9), information (8), new (8), run (8), enable (8), databases (8), set (8), high (8), availability (8), external (8), thumb (7), other (7), policies (7), open (7), linux (7), monitor (7), shell (7), googleapis (7), com (7), curl (7), management (7), vector (7), managed (7), read (7), need (6), learn (6), how (6), admin (6), api (6), then (6), delete (6), password (6), windows (6), which (6), tools (6), https (6), settings (6), choose (6), ssl (6), backups (6), performance (6), export (6), recovery (6), replication (6), replicas (6), service (6), authentication (6), code (5), samples (5), community (5), all (5), its (5), disable (5), account (5), client (5), enter (5), exe (5), note (5), make (5), public (5), gcloud (5), grant (5), add (5), required (5), free (5), environment (5), issues (5), certificates (5), tls (5), encryption (5), view (5), embeddings (5), app (5), version (5), português (4), system (4), down (4), troubleshoot (4), enabled (4), steps (4), user (4), instance_connection_name (4), start (4), uses (4), container (4), image (4), machine (4), file (4), save (4), executable (4), chmod (4), search (4), services (4), selector (4), selecting (4), resourcemanager (4), secure (4), usage (4), migration (4), compute (4), application (4), reconfigure (4), optimize (4), logs (4), query (4), language (4), build (4), best (4), practices (4), custom (4), disaster (4), control (4), users (4), organization (4), major (4), maintenance (4), sign (3), terms (3), architecture (3), started (3), products (3), understand (3), last (3), content (3), details (3), not (3), myinstance (3), used (3), these (3), verify (3), root (3), environments (3), get (3), included (3), but (3), images (3), docker (3), local (3), contains (3), right (3), install (3), running (3), must (3), whether (3), kernel (3), documentation (3), field (3), check (3), plan (3), perform (3), test (3), characters (3), character (3), production (3), authorized (3), networks (3), guides (3), observability (3), analytics (3), capacity (3), tables (3), reduce (3), table (3), prevent (3), backup (3), auditing (3), indexes (3), insights (3), mcp (3), queries (3), capture (3), audit (3), model (3), endpoint (3), reference (3), applications (3), files (3), restore (3), standard (3), migrate (3), vpc (3), pooling (3), customer (3), tags (3), place (3), trial (3), product (3), 한국어 (2), 日本語 (2), עברית (2), brasil (2), italiano (2), indonesia (2), français (2), español (2), américa (2), latina (2), deutsch (2), english (2), our (2), join (2), site (2), youtube (2), events (2), status (2), support (2), contact (2), pricing (2), updated (2), 2026 (2), utc (2), licensed (2), under (2), are (2), license (2), send (2), feedback (2), button (2), were (2), window (2), type (2), terminal (2), message (2), similar (2), prompt (2), appears (2), have (2), 3306 (2), 127 (2), connections (2), powershell (2), launch (2), region (2), operating (2), registry (2), gcr (2), pull (2), default (2), based (2), buster (2), alpine (2), distroless (2), rename (2), link (2), darwin (2), mac (2), amd64 (2), macos (2), uname (2), find (2), before (2), begin (2), installing (2), includes (2), example (2), address (2), list (2), operations (2), additional (2), rows (2), column (2), provides (2), billing (2), don (2), keep (2), procedure (2), instead (2), existing (2), after (2), finish (2), removing (2), associated (2), creator (2), permission (2), projects (2), projectcreator (2), doesn (2), require (2), specific (2), any (2), been (2), granted (2), between (2), edit (2), lowercase (2), letter (2), dash (2), configuration (2), sdk (2), languages (2), frameworks (2), infrastructure (2), costs (2), security (2), monitoring (2), networking (2), industry (2), solutions (2), distributed (2), hybrid (2), multicloud (2), pipelines (2), hosting (2), development (2), known (2), remove (2), log (2), loss (2), enabling (2), automated (2), number (2), memory (2), cache (2), improve (2), enterprise (2), plus (2), assistance (2), agents (2), saved (2), generate (2), invoke (2), predictions (2), dump (2), point (2), time (2), option (2), back (2), replicate (2), pool (2), pools (2), regional (2), kubernetes (2), flexible (2), phpmyadmin (2), authorize (2), write (2), keys (2), cmek (2), parameterized (2), views (2), studio (2), built (2), minor (2), network (2), edition (2), updates (2), shrink (2), cross (2), technology (2), areas (2), close (2), subscribe, newsletter, third, decade, climate, action, cookies, privacy, tech, twitter, blog, engage, training, certification, center, getting, github, release, notes, forums, sales, marketplace, easy, easytounderstand, solved, problem, solvedmyproblem, otherup, hard, hardtounderstand, incorrect, sample, incorrectinformationorsamplecode, missing, missingtheinformationsamplesineed, otherdown, tell, except, otherwise, noted, java, registered, trademark, oracle, affiliates, developers, apache, creative, commons, attribution, options, what, next, within, part, them, optional, cleanup, icon, bar, top, avoid, incurring, charges, follow, clean, return, where, should, connected, host, port, listening, ready, loud, own, output, replace, copied, previous, step, section, copy, format, projectid, instanceid, systems, here, compile, source, repository, supports, domain, serves, artifact, transition, latest, has, different, such, related, x86, x64, arm64, found, repeat, sudo, apt, 386, determine, binary, depends, most, newer, hardware, unsure, upgrading, directions, platform, created, including, returned, away, won, available, until, initializes, starts, menu, cli, each, another, identifier, typically, email, principals, person_add, specify, include, identify, group, groups, administrator, principal, sure, cloudsql, necessary, enables, sqladmin, follows, line, directly, browser, commands, presented, throughout, evaluate, real, world, scenarios, customers, also, 300, credits, deploy, workloads, when, form, suggests, first, digit, remaining, cannot, instructions, only, shouldn, shows, without, configuring, securely, postgresql, categorize, preferences, stay, organized, collections, home, updating, orphan, diagnose, debug, error, messages, looker, rotate, broad, ranges, underprovisioned, overprovisioned, idle, temporary, increasing, retention, out, cpu, disk, definitions, increase, reliability, enforce, apply, recommendations, active, index, advisor, natural, querydata, conversational, securing, agent, interactions, remote, work, preview, filter, register, interact, models, llm, powered, langchain, embedding, workflow, online, integrate, vertex, generative, develop, cancel, parallel, csv, importing, exporting, deleted, enhanced, advanced, legacy, percona, xtrabackup, physical, large, replicating, autoscaling, lag, promote, outside, functions, operator, dns, certificate, authority, across, multiple, vpcs, both, brute, force, protection, controls, endpoints, side, attach, fine, grained, conditions, permissions, identity, predefined, secret, manager, handle, secrets, residency, knowledge, catalog, gemini, execute, statements, update, collation, operational, guidelines, general, migrating, versions, troubleshooting, peering, allowlists, self, connectivity, tests, locations, flags, supported, deletion, label, stop, restart, clone, series, prepare, computer, key, features, editions, discover, skip, main,

Text of the page (random words):
proxy quickstart connect from your local computer plan and prepare overview choose a cloud sql edition choose a machine series choose a storage option region availability data cache overview create and manage instances create instances edit instances clone instances start stop and restart instances label instances delete instances prevent deletion of an instance supported instance settings view instance information configure database flags manage instance locations manage connectivity tests manage capacity about storage shrink shrink instance storage capacity manage maintenance updates maintenance updates on instances view and set maintenance windows perform self service maintenance upgrade upgrade an instance to cloud sql enterprise plus edition upgrade an instance by using in place upgrade upgrade an instance by using ip allowlists upgrade an instance by using vpc peering upgrade an instance to the new network architecture upgrade the database major version upgrade the database major version in place troubleshooting in place major version upgrade to mysql 8 0 known issues in mysql 8 0 minor versions upgrade the database major version by migrating data upgrade the database minor version use best practices general best practices operational guidelines databases create and manage databases update the character set and collation for a database execute sql statements using the cloud sql data api users about mysql users cloud sql built in database authentication manage users with built in authentication cloud sql studio manage your data using cloud sql studio write sql with gemini assistance manage your resources using knowledge catalog secure and control access overview about access control data residency overview use secret manager to handle secrets in cloud sql parameterized secure views overview use parameterized secure views organization policies cloud sql organization policies add predefined organization policies add custom organization policies identity and access management iam iam authentication roles and permissions use iam conditions configure instances for iam database authentication manage users with iam database authentication log in using iam database authentication fine grained access control with tags access control with google cloud tags attach and manage tags on cloud sql instances use encryption about client side encryption about customer managed encryption keys cmek use customer managed encryption keys cmek use cloud sql regional endpoints configure vpc service controls use cloud sql brute force protection connect choose how to connect to cloud sql authorize with authorized networks connect to an instance using public ip configure public ip connect to an instance using private ip learn about using private ip configure private ip configure private services access connect to an instance using a write endpoint private service connect overview connect to an instance using private service connect configure both private services access and private service connect connect to your instance across multiple vpcs connect using ssl tls certificates authorize with ssl tls certificates configure ssl tls certificates manage ssl tls certificates use a customer managed certificate authority ca set up a custom dns name connect using cloud sql language connectors cloud sql language connectors overview connect using the cloud sql language connectors connect using the cloud sql auth proxy about the cloud sql auth proxy connect using the cloud sql auth proxy connect using cloud sql proxy operator use managed connection pooling managed connection pooling overview configure managed connection pooling connect from applications connect using a mysql client connect from cloud run connect from cloud functions connect from app engine standard use phpmyadmin on app engine use phpmyadmin on cloud run connect from app engine flexible connect from compute engine connect from kubernetes engine connect from cloud build manage database connections connect from other mysql tools connect to an instance from outside its vpc replicate about replication in cloud sql create and manage replicas create read replicas manage read replicas create and manage indexes on read replicas promote replicas for regional migration or disaster recovery replication lag create and manage read pools about read pools create a read pool read pool autoscaling configure external replicas replicate from an external server about replicating from an external server configure cloud sql and the external server for replication use a managed import to set up replication from external databases use a dump file to set up replication from external databases use a custom import to set up replication from large external databases migrate data about data migration in cloud sql migrate from a percona xtrabackup physical file migrate from cloud sql to an external server availability and disaster recovery dr availability in cloud sql about high availability ha enable and disable high availability ha legacy configuration for high availability ha about disaster recovery dr use advanced disaster recovery dr back up and restore back up an instance cloud sql backups overview choose your backup option manage standard backups manage enhanced backups manage backups for deleted instances view audit logs for automated backups restore an instance overview restore an instance using a backup configure point in time recovery perform point in time recovery import and export best practices for importing and exporting data export and import using sql dump files export and import using csv files export and import files in parallel cancel the import and export of data check the status of import and export operations develop build generative ai applications using cloud sql integrate cloud sql with vertex ai invoke online predictions understand an example of an embedding workflow build llm powered applications using langchain interact with custom models using model endpoint management overview register a model generate embeddings invoke predictions model endpoint management reference vector search vector search enable and disable vector embeddings generate and manage vector embeddings create and manage vector indexes search and filter with vector embeddings work with vector embeddings preview use cloud sql for mysql with agents use the cloud sql remote mcp server best practices for securing agent interactions with mcp use saved queries overview create and manage saved queries build data agents with conversational analytics query database in natural language with querydata monitor and optimize about database observability monitor and troubleshoot with ai assistance audit audit logs mysql database auditing use mysql database auditing performance capture overview configure performance capture view performance capture logs query performance use query insights use index advisor monitor active queries system performance monitor instances view instance logs use system insights monitor cloud sql using the database insights mcp server apply recommendations create indexes or reconfigure join settings disable public ip enable database auditing enforce ssl tls encryption improve instance reliability by enabling high availability improve performance with enterprise plus increase the table open cache manage open tables and open table definitions manage high number of tables monitor disk availability optimize high cpu usage optimize high memory usage optimize instances with high number of out of memory events prevent data loss by enabling automated backups prevent data loss by increasing backup retention reconfigure connection settings reconfigure log settings reconfigure temporary table settings reduce idle cloud sql instances reduce overprovisioned cloud sql instances reduce underprovisioned cloud sql instances remove authorized networks remove broad public ip ranges rotate server certificates set instance password policies set user password policies use looker with cloud sql troubleshoot known issues troubleshoot error messages debug connection issues diagnose issues orphan tables issues updating storage capacity ai and ml application development application hosting compute data analytics and pipelines databases distributed hybrid and multicloud industry solutions migration networking observability and monitoring security storage access and resources management costs and usage management infrastructure as code sdk languages frameworks and tools home documentation databases cloud sql mysql guides send feedback stay organized with collections save and categorize content based on your preferences connect to cloud sql for mysql using the cloud sql auth proxy mysql postgresql sql server this page shows you how to connect to cloud sql from a local test environment using the cloud sql auth proxy the cloud sql auth proxy provides secure access to your cloud sql instance without the need for authorized networks or for configuring ssl by using the cloud sql auth proxy you can connect to your cloud sql instance securely the instructions on this page are for a test environment only and shouldn t be used for production environments for more information on the configuration required for production environments see use the cloud sql auth proxy in a production environment and connect using the cloud sql auth proxy before you begin note the name you use for your project must be between 4 and 30 characters when you type the name the form suggests a project id which you can edit the project id must be between 6 and 30 characters with a lowercase letter as the first character you can use a dash lowercase letter or digit for the remaining characters but the last character cannot be a dash sign in to your google cloud account if you re new to google cloud create an account to evaluate how our products perform in real world scenarios new customers also get 300 in free credits to run test and deploy workloads in the google cloud console on the project selector page select or create a google cloud project roles required to select or create a project select a project selecting a project doesn t require a specific iam role you can select any project that you ve been granted a role on create a project to create a project you need the project creator role roles resourcemanager projectcreator which contains the resourcemanager projects create permission learn how to grant roles note if you don t plan to keep the resources that you create in this procedure create a project instead of selecting an existing project after you finish these steps you can delete the project removing all resources associated with the project go to project selector verify that billing is enabled for your google cloud project in the google cloud console on the project selector page select or create a google cloud project roles required to select or create a project select a project selecting a project doesn t require a specific iam role you can select any project that you ve been granted a role on create a project to create a project you need the project creator role roles resourcemanager projectcreator which contains the resourcemanager projects create permission learn how to grant roles note if you don t plan to keep the resources that you create in this procedure create a project instead of selecting an existing project after you finish these steps you can delete the project removing all resources associated with the project go to project selector verify that billing is enabled for your google cloud project enable the necessary google cloud apis console in the google cloud console go to the apis page go to apis enable the cloud sql admin api gcloud click the following button to open cloud shell which provides command line access to your google cloud resources directly from the browser cloud shell can be used to run the gcloud commands presented throughout this quickstart open cloud shell run the gcloud services enable command as follows using cloud shell to enable the apis required for this quickstart gcloud services enable sqladmin googleapis com this command enables the following apis cloud sql admin api make sure that you have the following role or roles on the project cloud sql admin roles cloudsql admin check for the roles in the google cloud console go to the iam page go to iam select the project in the principal column find all rows that identify you or a group that you re included in to learn which groups you re included in contact your administrator for all rows that specify or include you check the role column to see whether the list of roles includes the required roles grant the roles in the google cloud console go to the iam page go to iam select the project click person_add grant access in the new principals field enter your user identifier this is typically the email address for a google account click select a role then search for the role to grant additional roles click add add another role and add each additional role click save create a cloud sql instance in this quickstart you use the google cloud console to use the gcloud cli curl or powershell see create instances in the google cloud console go to the cloud sql instances page go to cloud sql instances click create instance from the create instance menu select new instance click choose mysql in the instance id field enter myinstance in the password field enter a password for the root user click create instance you re returned to the instances list you can click the new instance right away to see the details but it won t be available for other operations until it initializes and starts note in this example the instance is created using default settings including a public ip address download the mysql community server for your platform from the mysql community server download page the community server includes the mysql client install the community server following the directions on the download page for more information about installing mysql see installing and upgrading mysql install the cloud sql auth proxy client the cloud sql auth proxy binary you download depends on your operating system and whether it uses a 32 bit or 64 bit kernel most newer hardware uses a 64 bit kernel if you re unsure whether your machine is running a 32 bit or 64 bit kernel then use the uname a command for linux or macos for windows see the windows documentation before you begin you must determine your machine s architecture if running on linux or mac you can find this by running the following command uname a linux 64 bit download the cloud sql auth proxy curl o cloud sql proxy https storage googleapis com cloud sql connectors cloud sql proxy v2 23 0 cloud sql proxy linux amd64 make the cloud sql auth proxy executable chmod x cloud sql proxy linux 32 bit download the cloud sql auth proxy curl o cloud sql proxy https storage googleapis com cloud sql connectors cloud sql proxy v2 23 0 cloud sql proxy linux 386 if th...