tencent cloud

TDSQL-C for MySQL

Release Notes and Announcements
Release Notes
Product Announcements
Beginner's Guide
Product Introduction
Overview
Strengths
Use Cases
Architecture
Product Specifications
Instance Types
Product Feature List
Database Versions
Regions and AZs
Common Concepts
Use Limits
Suggestions on Usage Specifications
Kernel Features
Kernel Overview
Kernel Version Release Notes
Optimized Kernel Version
Functionality Features
Performance Features
Security Features
Stability Feature
Analysis Engine Features
Inspection and Repair of Kernel Issues
Purchase Guide
Billing Overview
Product Pricing
Creating Cluster
Specification Adjustment Description
Renewal
Payment Overdue
Refund
Change from Pay-as-You-Go to Yearly/Monthly Subscription
Change from Pay-as-You-Go to Serverless Billing
Value-Added Services Billing Overview
Viewing Billing Statements
Getting Started
Database Audit
Overview
Viewing Audit Instance List
Enabling Audit Service
Viewing Audit Logs
Log Shipping
Post-Event Alarm Configuration
Modifying Audit Rule
Modifying Audit Service
Disabling Audit Service
Audit Rule Template
Viewing Audit Task
Authorizing Sub-User to Use Database Audit
Serverless Service
Serverless Introduction
Creating and Managing a Serverless Cluster
Elastic Scaling Management Tool
Serverless Resource Pack
Multi-AZ Deployment
Configuration Change
FAQs
Serverless Cost Estimator
Operation Guide
Operation Overview
Switching Cluster Page View in Console
Database Connection
Instance Management
Configuration Adjustment
Instance Mode Management
Cluster Management
Scaling Instance
Database Proxy
Account Management
Database Management
Database Management Tool
Parameter Configuration
Multi-AZ Deployment
GD
Backup and Restoration
Operation Log
Data Migration
Parallel Query
Columnar Storage Index (CSI)
Analysis Engine
Database Security and Encryption
Monitoring and Alarms
Basic SQL Operations
Connecting to TDSQL-C for MySQL Through SCF
Tag
Practical Tutorial
Classified Protection Practice for Database Audit of TDSQL-C for MySQL
Upgrading Database Version from MySQL 5.7 to 8.0 Through DTS
Usage Instructions for TDSQL-C MySQL
New Version of Console
Implementing Multiple RO Groups with Multiple Database Proxy Connection Addresses
Strengths of Database Proxy
Selecting Billing Mode for Storage Space
Creating Remote Disaster Recovery by DTS
Creating VPC for Cluster
Data Rollback
Solution to High CPU Utilization
How to Authorize Sub-Users to View Monitoring Data
White Paper
Security White Paper
Performance White Paper
Troubleshooting
Connection Issues
Performance Issues
API Documentation
History
Introduction
API Category
Making API Requests
Instance APIs
Multi-Availability Zone APIs
Other APIs
Audit APIs
Database Proxy APIs
Backup and Recovery APIs
Parameter Management APIs
Billing APIs
serverless APIs
Resource Package APIs
Account APIs
Performance Analysis APIs
Data Types
Error Codes
FAQs
Basic Concepts
Purchase and Billing
Compatibility and Format
Connection and Network
Features
Console Operations
Database and Table
Performance and Log
Database Audit
Between TDSQL-C for MySQL and TencentDB for MySQL
Service Agreement
Service Level Agreement
Terms of Service
TDSQL-C Policy
Privacy Policy
Data Privacy and Security Agreement
General References
Standards and Certifications
Glossary
Contact Us

Hint Syntax Usage

PDF
Focus Mode
Font Size
Last updated: 2025-12-24 15:28:01
This document describes how to use the hint syntax on the database proxy.
The hint syntax can be used to forcibly execute SQL requests on the specified instance. A hint has the highest routing priority, and it is not subject to consistency and transaction constraints. You need to evaluate whether it is required in your business scenario before using it.
Note:
When you use the TDSQL-C for MySQL command line for connection with the hint syntax, you need to add the -c option to the command. Otherwise, the hints will be filtered out by the command line tool.
For example, the command should be mysql -h hostname -u username -p -c for connection through the private network.
When you use the hint syntax on the database proxy, the prepare statement is supported for database proxy 1.3.3 and later versions.
The hint syntax in this document is case-insensitive in actual use.
Currently, four types of hints are supported.
Specify the read-write instance for execution:
-- Hint syntax
/* to master */
Or
/*FORCE_MASTER*/
-- Example
-- Specify the read-write instance to perform the query operation
SELECT /* to master */ * FROM users WHERE user_id = 1;

-- Specify the read-write instance to perform the update operation
UPDATE /* FORCE_MASTER */ orders SET status = 'shipped' WHERE order_id = 1001;
Specify a read-only instance for execution:
-- Hint syntax
/* to slave */
Or
/*FORCE_SLAVE*/
-- Example
-- Specify a read-only instance to perform the query operation
SELECT /* to slave */ * FROM products WHERE category = 'electronics';

-- Specify a read-only instance to perform the count operation
SELECT /* FORCE_SLAVE */ COUNT(*) FROM transactions WHERE status = 'completed';
Specify a read-only analysis engine for execution:
Note:
This execution method is only supported when the database proxy version is 1.4.4 or later. If multiple read-only analysis engines exist, load balancing will be performed based on weight rules.
-- Specify the read-only analysis engine to perform the query operation
SELECT /* to ap */ * FROM products WHERE category = 'electronics';
Specify a certain instance for execution:
-- Hint syntax
/* to server server_name */
-- Example
-- Specify the instance test_ro_1 to perform the query operation
SELECT /* to server test_ro_1 */ * FROM inventory WHERE product_id = 2002;
Note:
server_name in the above statement indicates the instance ID. You can obtain the ID of the target instance in the instance information area on the right side of the cluster details page (in tab view), as shown below.


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback