Краткое руководство. Использование языка Go для подключения и запроса данных в База данных Azure для MySQL

Статья
2024-11-27

В этом кратком руководстве объясняется, как подключиться к базе данных Azure для MySQL с помощью кода Go на платформе Windows, Ubuntu Linux или Apple macOS. Здесь также показано, как использовать инструкции SQL для запроса, вставки, обновления и удаления данных в базе данных. В этой статье предполагается, что у вас уже есть опыт разработки на языке Go и вы только начали работу с базой данных Azure для MySQL.

Необходимые компоненты

В качестве отправной точки в этом кратком руководстве используются ресурсы, созданные в соответствии со следующими материалами:

Внимание

Для этого краткого руководства рекомендуется использовать сервер с общедоступным доступом (разрешенными IP-адресами ). Использование сервера с закрытым доступом (интеграция с виртуальной сетью) для выполнения этого краткого руководства может включать дополнительные шаги, которые не рассматриваются.

Убедитесь, что IP-адрес, из который вы подключаетесь, был добавлен правила брандмауэра сервера с помощью правил управления брандмауэром для База данных Azure для MySQL — гибкий сервер с помощью портал Azure или управления правилами брандмауэра для База данных Azure для MySQL — гибкий сервер с помощью Azure CLI

Установка Go и соединителя MySQL

Установите Go и драйвер go-sql-driver для MySQL на своем компьютере. В зависимости от используемой платформы выполните действия, приведенные в соответствующем разделе.

Скачайте и установите Go для Microsoft Windows согласно инструкциям по установке.
Запустите командную строку из меню "Пуск".
Создайте папку для проекта, например mkdir %USERPROFILE%\go\src\mysqlgo.
Перейдите в папку проекта, например cd %USERPROFILE%\go\src\mysqlgo.
Задайте переменную среды для GOPATH, чтобы указать каталог исходного кода: set GOPATH=%USERPROFILE%\go
Запустите go mod init, чтобы создать модуль в текущем каталоге. Например: go mod init mysqlgo.
- Параметр <module_path> обычно обозначает расположение в репозитории GitHub, например github.com/<your_github_account_name>/<directory>.
- При создании приложения командной строки в качестве теста и публикации приложения <module_path> не требуется ссылаться на фактическое расположение. Например, mysqlgo.
Установите драйвер go-sql-driver для MySQL, выполнив команду go get github.com/go-sql-driver/mysql.

Установите Go, а затем выполните следующие команды в командной строке:
```
mkdir  %USERPROFILE%\go\src\mysqlgo
cd %USERPROFILE%\go\src\mysqlgo
set GOPATH=%USERPROFILE%\go
go mod init mysqlgo
go get github.com/go-sql-driver/mysql
```

Запустите оболочку Bash.
Установите Go, выполнив команду sudo apt-get install golang-go.
Создайте папку для проекта в корневом каталоге, например mkdir -p ~/go/src/mysqlgo/.
Перейдите в другую папку, например cd ~/go/src/mysqlgo/.
В качестве значения для переменной среды GOPATH укажите путь к действительному исходному каталогу, например к текущей папке Go в корневом каталоге. В оболочке Bash выполните команду export GOPATH=~/go, чтобы добавить каталог Go в качестве значения переменной GOPATH для текущего сеанса оболочки.
Запустите go mod init, чтобы создать модуль в текущем каталоге. Например: go mod init mysqlgo.
- Параметр <module_path> обычно обозначает расположение в репозитории GitHub, например github.com/<your_github_account_name>/<directory>.
- При создании приложения командной строки в качестве теста и публикации приложения <module_path> не требуется ссылаться на фактическое расположение. Например, mysqlgo.
Установите драйвер go-sql-driver для MySQL, выполнив команду go get github.com/go-sql-driver/mysql.

Выполните следующие команды Bash:
```
sudo apt-get install golang-go git -y
mkdir -p ~/go/src/mysqlgo/
cd ~/go/src/mysqlgo/
export GOPATH=~/go/
go mod init mysqlgo
go get github.com/go-sql-driver/mysql
```

Скачайте и установите Go согласно инструкциям по установке с учетом вашей платформы.
Запустите оболочку Bash.
Создайте папку для проекта в корневом каталоге, например mkdir -p ~/go/src/mysqlgo/.
Перейдите в другую папку, например cd ~/go/src/mysqlgo/.
В качестве значения для переменной среды GOPATH укажите путь к действительному исходному каталогу, например к текущей папке Go в корневом каталоге. В оболочке Bash выполните команду export GOPATH=~/go, чтобы добавить каталог Go в качестве значения переменной GOPATH для текущего сеанса оболочки.
Запустите go mod init, чтобы создать модуль в текущем каталоге. Например: go mod init mysqlgo.
- Параметр <module_path> обычно обозначает расположение в репозитории GitHub, например github.com/<your_github_account_name>/<directory>.
- При создании приложения командной строки в качестве теста и публикации приложения <module_path> не требуется ссылаться на фактическое расположение. Например, mysqlgo.
Установите драйвер go-sql-driver для MySQL, выполнив команду go get github.com/go-sql-driver/mysql.

Установите Go, а затем выполните следующие команды Bash:
```
mkdir -p ~/go/src/mysqlgo/
cd ~/go/src/mysqlgo/
export GOPATH=~/go/
go mod init mysqlgo
go get github.com/go-sql-driver/mysql
```

Получение сведений о подключении

Получите сведения о подключении, необходимые для подключения к базе данных Azure.для MySQL. Вам потребуется полное имя сервера и учетные данные для входа.

Войдите на портал Azure.
В меню слева на портале Azure выберите Все ресурсы и выполните поиск по имени созданного сервера (например, mydemoserver).
Выберите имя сервера.
Запишите имя сервера и имя для входа администратора сервера с панели сервера Обзор. Если вы забыли свой пароль, можно также сбросить пароль с помощью этой панели.

Сборка и выполнение кода Go

Для написания кода на Golang можно использовать простой текстовый редактор, например Блокнот в Microsoft Windows, vi или Nano в Ubuntu, а также TextEdit в macOS. Если вы предпочитаете использовать полнофункциональную интегрированную среду разработки, попробуйте Gogland от JetBrains, Visual Studio Code от корпорации Майкрософт или Atom.
Вставьте код Go из раздела ниже в текстовые файлы с расширением *.go и сохраните их в папке проекта, например %USERPROFILE%\go\src\mysqlgo\createtable.go в Windows или ~/go/src/mysqlgo/createtable.go в Linux.
Найдите константы host, database, user и password в коде и замените приведенные для примера значения своими собственными. База данных с именем flexibleserverdb создается при создании экземпляра сервера База данных Azure для MySQL. Эту базу данных или другую созданную базу данных можно использовать.
Запустите командную строку или оболочку Bash. Перейдите в папку проекта. В Windows это будет команда cd %USERPROFILE%\go\src\mysqlgo\, а в Linux — cd ~/go/src/mysqlgo/. Некоторые из упомянутых редакторов IDE позволяют выполнять отладку и использовать среду выполнения без применения команд оболочки.
Выполните код с помощью команды go run createtable.go, чтобы скомпилировать и запустить приложение.
Вы также можете создать код в собственном приложении. Для этого введите go build createtable.go, а затем выполните createtable.exe, чтобы запустить приложение.

Подключение, создание таблицы и вставка данных

Используйте следующий код для подключения к серверу, создания таблицы и загрузки данных с помощью инструкции SQL INSERT.

Код импортирует три пакета: пакет sql, драйвер go sql для MySQL для обмена данными с базой данных Azure для MySQL, а также пакет fmt для вывода входных и выходных данных в командной строке.

Код вызывает метод sql.Open(), чтобы подключиться к базе данных Azure для MySQL, а затем проверяет подключение с помощью метода db.Ping(). Дескриптор базы данных используется для всех компонентов. Он содержит пул подключений к серверу базы данных. Код вызывает метод Exec() несколько раз, чтобы выполнить несколько команд DDL. Код также использует методы Prepare() и Exec(), чтобы выполнить подготовленные инструкции с разными параметрами для вставки трех строк. При каждом запуске пользовательский метод checkError() проверяет наличие ошибок и инициирует аварийный выход в случае их обнаружения.

Замените значения констант host, database, user и password собственными значениями.

package main

import (
    "database/sql"
    "fmt"

    _ "github.com/go-sql-driver/mysql"
)

const (
    host     = "mydemoserver.mysql.database.azure.com"
    database = "flexibleserverdb"
    user     = "myadmin"
    password = "yourpassword"
)

func checkError(err error) {
    if err != nil {
        panic(err)
    }
}

func main() {

    // Initialize connection string.
    var connectionString = fmt.Sprintf("%s:%s@tcp(%s:3306)/%s?allowNativePasswords=true&tls=true", user, password, host, database)

    // Initialize connection object.
    db, err := sql.Open("mysql", connectionString)
    checkError(err)
    defer db.Close()

    err = db.Ping()
    checkError(err)
    fmt.Println("Successfully created connection to database.")

    // Drop previous table of same name if one exists.
    _, err = db.Exec("DROP TABLE IF EXISTS inventory;")
    checkError(err)
    fmt.Println("Finished dropping table (if existed).")

    // Create table.
    _, err = db.Exec("CREATE TABLE inventory (id serial PRIMARY KEY, name VARCHAR(50), quantity INTEGER);")
    checkError(err)
    fmt.Println("Finished creating table.")

    // Insert some data into table.
    sqlStatement, err := db.Prepare("INSERT INTO inventory (name, quantity) VALUES (?, ?);")
    res, err := sqlStatement.Exec("banana", 150)
    checkError(err)
    rowCount, err := res.RowsAffected()
    fmt.Printf("Inserted %d row(s) of data.\n", rowCount)

    res, err = sqlStatement.Exec("orange", 154)
    checkError(err)
    rowCount, err = res.RowsAffected()
    fmt.Printf("Inserted %d row(s) of data.\n", rowCount)

    res, err = sqlStatement.Exec("apple", 100)
    checkError(err)
    rowCount, err = res.RowsAffected()
    fmt.Printf("Inserted %d row(s) of data.\n", rowCount)
    fmt.Println("Done.")
}

Чтение данных

Используйте указанный ниже код с инструкцией SQL SELECT для подключения и чтения данных.

Код вызывает метод sql.Open(), чтобы подключиться к базе данных Azure для MySQL, а затем проверяет подключение с помощью метода db.Ping(). Дескриптор базы данных используется для всех компонентов. Он содержит пул подключений к серверу базы данных. Код вызывает метод Query() для выполнения команды SELECT. Затем он запускает метод Next(), чтобы выполнить итерацию результирующего набора, и метод Scan() для анализа значений столбца, сохраняя значения в переменных. При каждом запуске пользовательский метод checkError() проверяет наличие ошибок и инициирует аварийный выход в случае их обнаружения.

Замените значения констант host, database, user и password собственными значениями.

package main

import (
    "database/sql"
    "fmt"

    _ "github.com/go-sql-driver/mysql"
)

const (
    host     = "mydemoserver.mysql.database.azure.com"
    database = "flexibleserverdb"
    user     = "myadmin"
    password = "yourpassword"
)

func checkError(err error) {
    if err != nil {
        panic(err)
    }
}

func main() {

    // Initialize connection string.
    var connectionString = fmt.Sprintf("%s:%s@tcp(%s:3306)/%s?allowNativePasswords=true&tls=true", user, password, host, database)

    // Initialize connection object.
    db, err := sql.Open("mysql", connectionString)
    checkError(err)
    defer db.Close()

    err = db.Ping()
    checkError(err)
    fmt.Println("Successfully created connection to database.")

    // Variables for printing column data when scanned.
    var (
        id       int
        name     string
        quantity int
    )

    // Read some data from the table.
    rows, err := db.Query("SELECT id, name, quantity from inventory;")
    checkError(err)
    defer rows.Close()
    fmt.Println("Reading data:")
    for rows.Next() {
        err := rows.Scan(&id, &name, &quantity)
        checkError(err)
        fmt.Printf("Data row = (%d, %s, %d)\n", id, name, quantity)
    }
    err = rows.Err()
    checkError(err)
    fmt.Println("Done.")
}

Обновление данных

Используйте указанный ниже код с инструкцией SQL UPDATE для подключения и обновления данных.

Код вызывает метод sql.Open(), чтобы подключиться к базе данных Azure для MySQL, а затем проверяет подключение с помощью метода db.Ping(). Дескриптор базы данных используется для всех компонентов. Он содержит пул подключений к серверу базы данных. Код вызывает метод Exec() для выполнения команды UPDATE. При каждом запуске пользовательский метод checkError() проверяет наличие ошибок и инициирует аварийный выход в случае их обнаружения.

Замените значения констант host, database, user и password собственными значениями.

package main

import (
    "database/sql"
    "fmt"

    _ "github.com/go-sql-driver/mysql"
)

const (
    host     = "mydemoserver.mysql.database.azure.com"
    database = "flexibleserverdb"
    user     = "myadmin"
    password = "yourpassword"
)

func checkError(err error) {
    if err != nil {
        panic(err)
    }
}

func main() {

    // Initialize connection string.
    var connectionString = fmt.Sprintf("%s:%s@tcp(%s:3306)/%s?allowNativePasswords=true&tls=true", user, password, host, database)

    // Initialize connection object.
    db, err := sql.Open("mysql", connectionString)
    checkError(err)
    defer db.Close()

    err = db.Ping()
    checkError(err)
    fmt.Println("Successfully created connection to database.")

    // Modify some data in table.
    rows, err := db.Exec("UPDATE inventory SET quantity = ? WHERE name = ?", 200, "banana")
    checkError(err)
    rowCount, err := rows.RowsAffected()
    fmt.Printf("Updated %d row(s) of data.\n", rowCount)
    fmt.Println("Done.")
}

Удаление данных

Используйте указанный ниже код с инструкцией SQL DELETE для подключения и удаления данных.

Код вызывает метод sql.Open(), чтобы подключиться к базе данных Azure для MySQL, а затем проверяет подключение с помощью метода db.Ping(). Дескриптор базы данных используется для всех компонентов. Он содержит пул подключений к серверу базы данных. Код вызывает метод Exec() для выполнения команды DELETE. При каждом запуске пользовательский метод checkError() проверяет наличие ошибок и инициирует аварийный выход в случае их обнаружения.

Замените значения констант host, database, user и password собственными значениями.

package main

import (
    "database/sql"
    "fmt"
    _ "github.com/go-sql-driver/mysql"
)

const (
    host     = "mydemoserver.mysql.database.azure.com"
    database = "flexibleserverdb"
    user     = "myadmin"
    password = "yourpassword"
)

func checkError(err error) {
    if err != nil {
        panic(err)
    }
}

func main() {

    // Initialize connection string.
    var connectionString = fmt.Sprintf("%s:%s@tcp(%s:3306)/%s?allowNativePasswords=true&tls=true", user, password, host, database)

    // Initialize connection object.
    db, err := sql.Open("mysql", connectionString)
    checkError(err)
    defer db.Close()

    err = db.Ping()
    checkError(err)
    fmt.Println("Successfully created connection to database.")

    // Modify some data in table.
    rows, err := db.Exec("DELETE FROM inventory WHERE name = ?", "orange")
    checkError(err)
    rowCount, err := rows.RowsAffected()
    fmt.Printf("Deleted %d row(s) of data.\n", rowCount)
    fmt.Println("Done.")
}

Очистка ресурсов

Чтобы очистить все ресурсы, используемые во время этого краткого руководства, удалите группу ресурсов с помощью следующей команды:

az group delete \
    --name $AZ_RESOURCE_GROUP \
    --yes

Следующий шаг

Перенос База данных Azure для MySQL — гибкая база данных сервера с помощью импорта и экспорта

Поделиться через

Краткое руководство. Использование языка Go для подключения и запроса данных в База данных Azure для MySQL

Необходимые компоненты

Установка Go и соединителя MySQL

Получение сведений о подключении

Сборка и выполнение кода Go

Подключение, создание таблицы и вставка данных

Чтение данных

Обновление данных

Удаление данных

Очистка ресурсов

Следующий шаг

Обратная связь

Дополнительные ресурсы