Часть hosts записывается в формате host:port. Это пример простого URL-адреса для подключения к одному хосту:

jdbc:mysql://host1:33060/sakila

host может быть строкой имени хоста IPv4 или IPv6, а в последнем случае она должна быть помещена в квадратные скобки, например “[1000:2000::abcd].” Если host не указано, используется значение по умолчанию localhost.

port — стандартный номер порта, т. е. целое число от 1 до 65535. Номер порта по умолчанию для обычного подключения к MySQL — 3306, а для подключения с использованием протокола X — 33060. Если port не указано, используется соответствующее значение по умолчанию.

В этом случае хост определяется как последовательность пар ключ-значение. Ключи используются для идентификации хоста, порта, а также любых свойств, специфичных для хоста. Существуют два альтернативных формата для указания ключей:

Хост и порт идентифицируются ключами host и port. Описания формата и значений по умолчанию для host и port в Раздел «Один хост без свойств, специфичных для хоста» выше также применяются здесь.

Другие добавляемые ключи включают user, password, protocol и так далее. Они переопределяют глобальные значения, заданные в properties части URL. Ограничьте переопределения пользователем, паролем, тайм-аутами сети и размерами кэша заявок и метаданных; эффекты других переопределений на основе хоста не определены.

Разные протоколы могут требовать разные ключи. Например, схема mysqlx: использует два специальных ключа, address и priority. address — пара host:port, а priority — целое число. Например:

mysqlx://(address=host:1111,priority=1,key1=value1)/db

key — чувствителен к регистру. Два ключа, отличающиеся только регистром, считаются конфликтующими, и нет гарантий, какой из них будет использован.

Хосты перечисляются в списке, разделенном запятыми:

host1,host2,...,hostN

Каждый хост может быть указан любым из трёх способов, описанных в Раздел «Один хост» выше. Вот некоторые примеры:

jdbc:mysql://myhost1:1111,myhost2:2222/db
jdbc:mysql://address=(host=myhost1)(port=1111)(key1=value1),address=(host=myhost2)(port=2222)(key2=value2)/db
jdbc:mysql://(host=myhost1,port=1111,key1=value1),(host=myhost2,port=2222,key2=value2)/db
jdbc:mysql://myhost1:1111,(host=myhost2,port=2222,key2=value2)/db
mysqlx://(address=host1:1111,priority=1,key1=value1),(address=host2:2222,priority=2,key2=value2)/db

Хосты перечисляются в списке, разделенном запятыми, а затем список заключается в квадратные скобки:

[host1,host2,...,hostN]

Это называется формой подсписка хостов, которая позволяет совместно использовать Учетные данные пользователя всеми хостами в списке, как будто они один хост. Каждый хост в списке может быть указан любым из трёх способов, описанных в Раздел «Один хост» выше. Вот некоторые примеры:

jdbc:mysql://sandy:secret@[myhost1:1111,myhost2:2222]/db
jdbc:mysql://sandy:secret@[address=(host=myhost1)(port=1111)(key1=value1),address=(host=myhost2)(port=2222)(key2=value2)]/db
jdbc:mysql://sandy:secret@[myhost1:1111,address=(host=myhost2)(port=2222)(key2=value2)]/db

Хотя вложенные списки хостов невозможно написать рекурсивно, список хостов может содержать подсписки хостов как своих членов.

Предположите за один хост, подсписком хостов (см. Раздел «Несколько хостов») или любым хостом в списке хостов с учетными данными пользователя с помощью @:

 user:password@host_or_host_sublist

Например:

mysqlx://sandy:secret@[(address=host1:1111,priority=1,key1=value1),(address=host2:2222,priority=2,key2=value2))]/db

Используйте ключи user и password для указания учетных данных для каждого хоста:

(user=sandy)(password=mypass)

Например:

jdbc:mysql://[(host=myhost1,port=1111,user=sandy,password=secret),(host=myhost2,port=2222,user=finn,password=secret)]/db
jdbc:mysql://address=(host=myhost1)(port=1111)(user=sandy)(password=secret),address=(host=myhost2)(port=2222)(user=finn)(password=secret)/db