Параметры подключения к базе данных можно задать вручную в файле

Обновлено: 03.07.2024

Workbench: выберите «Инструменты» > «Параметры FME» и щелкните значок «Подключение к базе данных».

Используйте окно "Подключения к базе данных" для управления подключениями к базе данных.

Чтобы добавить подключение к базе данных

Обычно удобнее добавлять подключение к базе данных в то время, когда вы хотите использовать его в рабочей области. Однако вы также можете добавить подключение непосредственно в подключения к базе данных параметров FME и использовать это подключение позже в рабочей области.

Нажмите кнопку "Добавить" .
В диалоговом окне "Добавить подключение к базе данных" укажите тип базы данных и параметры подключения и нажмите "Сохранить" .

Видимость: это поле применяется только в том случае, если Хранилище подключений, как указано в Инструменты > Параметры FME > Пути по умолчанию, является общим расположением, видимым для нескольких пользователей. Укажите, доступно ли подключение только вам или любому пользователю базы данных ( Public ). Для получения дополнительной информации нажмите «Справка» в окне «Пути по умолчанию» в разделе «Инструменты» > «Параметры FME».

Совет. Чтобы заполнить диалоговое окно "Добавить подключение к базе данных" параметрами существующего подключения, выберите подключение, нажмите и внесите необходимые изменения.

Чтобы изменить подключение к базе данных

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

Дважды щелкните подключение, которое хотите изменить.
В диалоговом окне редактирования отредактируйте нужные параметры подключения и нажмите "Сохранить" .

Чтобы изменить видимость подключения к базе данных

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

Убедитесь, что путь к данным и файл открытого ключа в меню Инструменты > Параметры FME > Пути по умолчанию > Хранилище подключений ссылаются на общее общее расположение, видимое нескольким пользователям.
Убедитесь, что вы вручную переместили файлы fme_connections.data и fme_publicKey.jceks, на которые ссылается путь к данным и файл открытого ключа, в расположение, указанное на шаге 1.
В диалоговом окне "Подключения к базе данных" ( "Инструменты" > "Параметры FME" > "Подключения к базе данных") установите флажок в разделе "Общедоступный", соответствующий подключению, которое вы хотите сделать доступным. Или, чтобы ограничить подключение к себе, снимите флажок.

Чтобы удалить соединение с базой данных

Выберите подключение и нажмите кнопку "Удалить" .

Чтобы изменить место хранения файла подключений

Вы можете изменить место хранения файла конфигурации подключения. Это изменение вносится в инструмент Инструменты > Параметры FME > Пути по умолчанию.

Справочное руководство по MySQL 8.0 / . / Программы MySQL / Использование программ MySQL / Подключение к серверу с использованием строк, подобных URI, или пар ключ-значение

4.2.5 Подключение к серверу с использованием строк, подобных URI, или пар ключ-значение

В этом разделе описывается использование строк соединения, подобных URI, или пар ключ-значение, чтобы указать, как устанавливать соединения с сервером MySQL для таких клиентов, как MySQL Shell. Для получения информации об установлении соединений с использованием параметров командной строки для таких клиентов, как mysql или mysqldump, см. Раздел 4.2.4, «Подключение к серверу MySQL с использованием параметров команды». Для получения дополнительной информации, если вы не можете подключиться, см. Раздел 6.2.22, «Устранение неполадок при подключении к MySQL».

Термин "подобный URI" означает синтаксис строки подключения, который похож, но не идентичен синтаксису URI (унифицированного идентификатора ресурса), определенному в RFC 3986.

Следующие клиенты MySQL поддерживают подключение к серверу MySQL с помощью строки подключения, похожей на URI, или пар ключ-значение:

Коннекторы MySQL, реализующие X DevAPI

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

Параметры соединения не чувствительны к регистру. Каждый параметр, если он указан, может быть задан только один раз. Если параметр указан более одного раза, возникает ошибка.

В этом разделе рассматриваются следующие темы:

Параметры базового соединения

В следующем обсуждении описываются параметры, доступные при указании подключения к MySQL. Эти параметры могут быть предоставлены либо в виде строки, которая соответствует базовому синтаксису, подобному URI (см. Соединение с использованием строк соединения, подобных URI), либо в виде пар ключ-значение (см. Соединение с использованием пар ключ-значение).

scheme : используемый транспортный протокол. Используйте mysqlx для соединений по протоколу X и mysql для соединений по классическому протоколу MySQL. Если протокол не указан, сервер пытается угадать протокол. Соединители, поддерживающие DNS SRV, могут использовать схему mysqlx+srv (см. Подключения с использованием записей DNS SRV).

пользователь : учетная запись пользователя MySQL для аутентификации.

пароль : пароль для аутентификации.

Указание явного пароля в спецификации подключения небезопасно и не рекомендуется. Позже будет показано, как вызвать интерактивный запрос пароля.

хост : хост, на котором работает экземпляр сервера. Значение может быть именем хоста, адресом IPv4 или адресом IPv6. Если хост не указан, по умолчанию используется localhost .

port : сетевой порт TCP/IP, на котором целевой сервер MySQL прослушивает соединения. Если порт не указан, по умолчанию используется 33060 для соединений по протоколу X и 3306 для соединений по классическому протоколу MySQL.

socket : путь к файлу сокета Unix или имя именованного канала Windows. Значения являются локальными путями к файлам. В строках, подобных URI, они должны быть закодированы либо с использованием процентного кодирования, либо путем заключения пути в круглые скобки. Круглые скобки устраняют необходимость процентного кодирования символов, таких как символ разделителя каталогов /. Например, чтобы подключиться как root@localhost с помощью сокета Unix /tmp/mysql.sock , укажите путь, используя кодировку в процентах, как root@localhost?socket=%2Ftmp%2Fmysql.sock или используя круглые скобки как root@localhost?socket= (/tmp/mysql.sock) .

схема : база данных по умолчанию для подключения. Если база данных не указана, у соединения нет базы данных по умолчанию.

Обработка localhost в Unix зависит от типа транспортного протокола. Соединения, использующие классический протокол MySQL, обрабатывают локальный хост так же, как и другие клиенты MySQL, что означает, что локальный хост предполагается для соединений на основе сокетов. Для соединений с использованием протокола X поведение localhost отличается тем, что предполагается, что он представляет адрес обратной связи, например, адрес IPv4 127.0.0.1.

Дополнительные параметры соединения

Вы можете указать параметры подключения либо в виде атрибутов в строке типа URI, добавив ? attribute=value или в виде пар "ключ-значение". Доступны следующие параметры:

режим ssl : желаемое состояние безопасности для подключения. Допустимы следующие режимы:

Информацию об этих режимах см. в описании параметра --ssl-mode в разделе Параметры команды для зашифрованных соединений.

ssl-ca : путь к файлу центра сертификации X.509 в формате PEM.

ssl-capath : путь к каталогу, содержащему файлы центров сертификации X.509 в формате PEM.

ssl-cert : путь к файлу сертификата X.509 в формате PEM.

ssl-cipher . Шифр шифрования для соединений, использующих протоколы TLS вплоть до TLSv1.2.

ssl-crl : путь к файлу, содержащему списки отозванных сертификатов в формате PEM.

ssl-crlpath : путь к каталогу, содержащему файлы списка отзыва сертификатов в формате PEM.

ssl-key : путь к файлу ключа X.509 в формате PEM.

tls-version : протоколы TLS, разрешенные для зашифрованных соединений по классическому протоколу MySQL. Эта опция поддерживается только MySQL Shell. Значение tls-version (в единственном числе) представляет собой список, разделенный запятыми, например, TLSv1.2,TLSv1.3 . Подробнее см. Раздел 6.3.2, «Протоколы и шифры TLS для зашифрованного соединения». Этот параметр зависит от того, не установлен ли для параметра ssl-mode значение DISABLED .

tls-versions: допустимые протоколы TLS для зашифрованных подключений по протоколу X. Значение tls-versions (во множественном числе) — это массив, такой как [TLSv1.2,TLSv1.3] . Подробнее см. Раздел 6.3.2, «Протоколы и шифры TLS для зашифрованного соединения». Этот параметр зависит от того, не установлен ли для параметра ssl-mode значение DISABLED .

tls-ciphersuites : разрешенные наборы шифров TLS. Значение tls-ciphersuites — это список имен наборов шифров IANA, перечисленных в TLS Ciphersuites. Подробнее см. Раздел 6.3.2, «Протоколы и шифры TLS для зашифрованного соединения». Этот параметр зависит от того, не установлен ли для параметра ssl-mode значение DISABLED .

auth-method : метод аутентификации для подключения. По умолчанию стоит AUTO, что означает, что сервер пытается угадать. Допустимы следующие методы:

Для подключений по протоколу X любой настроенный метод аутентификации заменяется следующей последовательностью методов аутентификации: MYSQL41 , SHA256_MEMORY , PLAIN .

get-server-public-key : запросить у сервера открытый ключ, необходимый для обмена паролями на основе пары ключей RSA. Используйте при подключении к серверам MySQL 8.0 по классическому протоколу MySQL с отключенным режимом SSL. В этом случае необходимо указать протокол. Например:

Этот параметр применяется к клиентам, которые проходят аутентификацию с помощью подключаемого модуля аутентификации caching_sha2_password. Для этого плагина сервер не отправляет открытый ключ, если он не запрошен. Этот параметр игнорируется для учетных записей, которые не аутентифицируются с помощью этого плагина.Он также игнорируется, если обмен паролями на основе RSA не используется, как в случае, когда клиент подключается к серверу, используя безопасное соединение.

Если указан server-public-key-path= file_name и указан допустимый файл открытого ключа, он имеет приоритет над get-server-public-key .

Информацию о подключаемом модуле caching_sha2_password см. в разделе 6.4.1.2, «Кэширование подключаемой аутентификации SHA-2».

server-public-key-path : Путь к файлу в формате PEM, содержащему клиентскую копию открытого ключа, необходимого серверу для обмена паролями на основе пары ключей RSA. Используйте при подключении к серверам MySQL 8.0 по классическому протоколу MySQL с отключенным режимом SSL .

Этот параметр применяется к клиентам, которые проходят аутентификацию с помощью подключаемого модуля аутентификации sha256_password или caching_sha2_password. Этот параметр игнорируется для учетных записей, которые не проходят аутентификацию с помощью одного из этих плагинов. Он также игнорируется, если обмен паролями на основе RSA не используется, как в случае, когда клиент подключается к серверу, используя безопасное соединение.

ssh : URI для подключения к серверу SSH для доступа к экземпляру сервера MySQL с использованием туннелирования SSH. Формат URI: [user@]host[:port] . Используйте параметр uri, чтобы указать URI целевого экземпляра сервера MySQL. Информацию о туннельных подключениях SSH из MySQL Shell см. в разделе Использование туннеля SSH.

uri : URI экземпляра сервера MySQL, доступ к которому осуществляется через туннель SSH с сервера, указанного параметром ssh. Формат URI: [схема://][пользователь@]хост[:порт] . Не используйте параметры базового подключения (схема, пользователь, хост, порт), чтобы указать подключение к серверу MySQL для туннелирования SSH, просто используйте параметр uri.

ssh-password : пароль для подключения к SSH-серверу.

Указание явного пароля в спецификации подключения небезопасно и не рекомендуется. MySQL Shell запрашивает пароль в интерактивном режиме, когда он требуется.

ssh-config-file : файл конфигурации SSH для подключения к серверу SSH. Вы можете использовать параметр конфигурации MySQL Shell ssh.configFile, чтобы установить пользовательский файл по умолчанию, если этот параметр не указан. Если ssh.configFile не задан, по умолчанию используется стандартный файл конфигурации SSH ~/.ssh/config .

ssh-identity-file : файл идентификации, используемый для подключения к серверу SSH. По умолчанию, если этот параметр не указан, используется любой файл идентификации, настроенный в агенте SSH (если он используется), или в файле конфигурации SSH, или в стандартном файле закрытого ключа в папке конфигурации SSH ( ~/.ssh/id_rsa ).< /p>

ssh-identity-pass : фраза-пароль для файла удостоверений, указанного параметром ssh-identity-file.

connect-timeout : целочисленное значение, используемое для настройки количества секунд, в течение которых клиенты, такие как MySQL Shell, ждут, пока не перестанут пытаться подключиться к неотвечающему серверу MySQL.

сжатие: этот параметр запрашивает или отключает сжатие для соединения. До версии MySQL 8.0.19 он работает только для соединений по классическому протоколу MySQL, а начиная с версии MySQL 8.0.20 он также работает для соединений по протоколу X.

Вплоть до версии MySQL 8.0.19 значение этого параметра равно true (или 1), что включает сжатие, и значение по умолчанию false (или 0), которое отключает сжатие.

Начиная с MySQL 8.0.20, значения для этой опции являются обязательными , которая запрашивает сжатие и дает сбой, если сервер не поддерживает его; предпочтительный , который запрашивает сжатие и возвращается к несжатому соединению; и disabled , который запрашивает несжатое соединение и терпит неудачу, если сервер не разрешает это. предпочтительным является значение по умолчанию для подключений по протоколу X, а отключено — значение по умолчанию для соединений по классическому протоколу MySQL. Для получения информации об управлении сжатием соединения X-плагина см. Раздел 20.5.5, «Сжатие соединения с X-плагином».

Обратите внимание, что разные клиенты MySQL по-разному реализуют поддержку сжатия соединений. Подробности смотрите в документации вашего клиента.

алгоритмы сжатия и уровень сжатия : эти параметры доступны в MySQL Shell 8.0.20 и более поздних версиях для большего контроля над сжатием соединения. Вы можете указать их, чтобы выбрать алгоритм сжатия, используемый для соединения, и числовой уровень сжатия, используемый с этим алгоритмом. Вы также можете использовать алгоритмы сжатия вместо сжатия, чтобы запросить сжатие для соединения. Информацию об управлении сжатием соединений в MySQL Shell см. в разделе Использование сжатых соединений.

connection-attributes: управляет парами ключ-значение, которые прикладные программы передают на сервер во время подключения.Для получения общей информации об атрибутах подключения см. Раздел 27.12.9, «Таблицы атрибутов подключения схемы производительности». Клиенты обычно определяют набор атрибутов по умолчанию, который можно отключить или включить. Например:

Поведение по умолчанию заключается в отправке набора атрибутов по умолчанию. Приложения могут указывать атрибуты для передачи в дополнение к атрибутам по умолчанию. Вы указываете дополнительные атрибуты подключения в качестве параметра атрибутов подключения в строке подключения. Значение параметра connection-attributes должно быть пустым (так же, как указание true ), логическим значением (true или false, чтобы включить или отключить набор атрибутов по умолчанию), или списком, или нулем или более спецификаторов key=value, разделенных запятыми (чтобы быть отправлено в дополнение к набору атрибутов по умолчанию). В списке отсутствующее значение ключа оценивается как пустая строка. Другие примеры:

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

Подключение с использованием строк подключения, подобных URI

Вы можете указать подключение к серверу MySQL с помощью строки, похожей на URI. Такие строки можно использовать с оболочкой MySQL с параметром команды --uri, командой \connect оболочки MySQL и соединителями MySQL, которые реализуют X DevAPI.

Строка подключения, похожая на URI, имеет следующий синтаксис:

Процентное кодирование должно использоваться для зарезервированных символов в элементах строки, подобной URI. Например, если вы указываете строку, содержащую символ @, этот символ необходимо заменить на %40. Если вы включаете идентификатор зоны в IPv6-адрес, символ %, используемый в качестве разделителя, необходимо заменить на %25 .

Параметры, которые можно использовать в строке подключения типа URI, описаны в разделе «Базовые параметры подключения».

Методы оболочки MySQL shell.parseUri() и shell.unparseUri() можно использовать для деконструкции и сборки строки подключения, подобной URI. При наличии строки подключения, похожей на URI, shell.parseUri() возвращает словарь, содержащий каждый элемент, найденный в строке. shell.unparseUri() преобразует словарь компонентов URI и параметров подключения в допустимую строку подключения, подобную URI, для подключения к MySQL, которую можно использовать в MySQL Shell или MySQL Connectors, которые реализуют X DevAPI.

Если в строке типа URI не указан пароль, что рекомендуется, интерактивные клиенты запрашивают пароль. В следующих примерах показано, как указать строки, подобные URI, с именем пользователя user_name . В каждом случае запрашивается пароль.

Подключение по протоколу X к экземпляру локального сервера, прослушивающему порт 33065.

Соединение по классическому протоколу MySQL с экземпляром локального сервера, прослушивающим порт 3333.

Подключение по протоколу X к экземпляру удаленного сервера с использованием имени хоста, адреса IPv4 и адреса IPv6.

Соединение по X-протоколу с использованием сокета, где путь указан либо в процентах, либо в круглых скобках.

Можно указать необязательный путь, представляющий базу данных.

Можно указать необязательный запрос, состоящий из значений, каждое из которых задано как пара ключ = значение или как один ключ . Чтобы указать несколько значений, разделите их символами , . Допускается сочетание значений key = value и key. Значения могут иметь тип списка со значениями списка, упорядоченными по внешнему виду. Строки должны быть либо закодированы в процентах, либо заключены в круглые скобки. Следующие эквивалентны.

Чтобы указать версию TLS и набор шифров для использования в зашифрованных соединениях:

В предыдущих примерах предполагается, что для подключения требуется пароль. В интерактивных клиентах указанный пароль пользователя запрашивается при входе в систему. Если учетная запись пользователя не имеет пароля (что небезопасно и не рекомендуется) или если используется одноранговая аутентификация сокета (например, с соединениями сокета Unix), вы должны явно указать в строке подключения, что пароль не предоставляется. и запрос пароля не требуется. Для этого поместите : после user_name в строку, но не указывайте после него пароль. Например:

Подключение с помощью пар "ключ-значение"

В MySQL Shell и некоторых соединителях MySQL, которые реализуют X DevAPI, вы можете указать соединение с сервером MySQL, используя пары ключ-значение, предоставленные в естественных для языка конструкциях для реализации. Например, вы можете указать параметры соединения, используя пары ключ-значение, как объект JSON в JavaScript или как словарь в Python. Независимо от того, как предоставляются пары ключ-значение, концепция остается неизменной: ключам, как описано в этом разделе, могут быть назначены значения, которые используются для указания соединения. Вы можете указать соединения, используя пары ключ-значение в методе shell.connect() оболочки MySQL или dba InnoDB Cluster.createCluster() и с некоторыми коннекторами MySQL, которые реализуют X DevAPI.

Как правило, пары "ключ-значение" заключаются в символы < и >, а символ , используется в качестве разделителя между парами "ключ-значение". Символ : используется между ключами и значениями, а строки должны быть разделены (например, с помощью символа '). Нет необходимости процентно кодировать строки, в отличие от строк подключения, подобных URI.

Соединение, указанное в виде пары "ключ-значение", имеет следующий формат:

Параметры, которые можно использовать в качестве ключей для подключения, описаны в разделе «Базовые параметры подключения».

Если в парах ключ-значение пароль не указан, что рекомендуется, интерактивные клиенты запрашивают пароль. В следующих примерах показано, как указать соединения с помощью пар ключ-значение с именем пользователя ' user_name ' . В каждом случае запрашивается пароль.

Подключение по протоколу X к экземпляру локального сервера, прослушивающему порт 33065.

Соединение по классическому протоколу MySQL с экземпляром локального сервера, прослушивающим порт 3333.

Соединение по протоколу X с использованием сокета.

Можно указать дополнительную схему, представляющую базу данных.

В предыдущих примерах предполагается, что для подключения требуется пароль. В интерактивных клиентах указанный пароль пользователя запрашивается при входе в систему. Если учетная запись пользователя не имеет пароля (что небезопасно и не рекомендуется) или если используется одноранговая аутентификация сокета (например, с соединениями сокета Unix), вы должны явно указать, что пароль не предоставляется, а запрос пароля не требуется. Для этого укажите пустую строку, используя '' после ключа пароля. Например:

Подключение к базе данных — это объект SQL Developer, который указывает необходимую информацию для подключения к определенной базе данных в качестве определенного пользователя этой базы данных. У вас должно быть хотя бы одно подключение к базе данных (существующее, созданное или импортированное), чтобы использовать SQL Developer.

Чтобы создать подключение к базе данных:

В навигаторе Connections в SQL Developer щелкните правой кнопкой мыши узел Connections и выберите New Connection .

Появится диалоговое окно «Создать/выбрать подключение к базе данных» с отображаемой вкладкой Oracle.

В поле Имя подключения введите имя, которое будет использоваться для этого подключения к базе данных.

В поле Имя пользователя введите имя пользователя, для которого создается это подключение к базе данных.

В поле "Пароль" введите пароль пользователя.

В поле Тип подключения выберите тип подключения к базе данных.

Когда вы выбираете тип подключения, поля ниже изменятся в соответствии с выбранным типом подключения. В этом примере описываются поля для основного типа подключения.

В поле "Роль" выберите "По умолчанию" или "SYSDBA" в зависимости от роли, назначенной пользователю.

В поле Имя хоста введите имя хоста, на котором расположена база данных.

В поле Порт введите порт базы данных.

В поле SID введите SID для базы данных (если подключение к базе данных предназначено для пользователя, не являющегося пользователем CDB, или для пользователя многопользовательской контейнерной базы данных (CDB):

Когда подключение к базе данных не-CDB или CDB создается для пользователя с правами администратора, такого как SYS , SYSDBA обычно указывается в поле Роль для подключения.

В поле Имя службы введите имя службы для подключаемой базы данных (PDB), включая имя домена (если подключение к базе данных предназначено для пользователя PDB):

Когда подключение базы данных к PDB создается для административного пользователя, такого как SYS , SYSDBA обычно указывается в поле Роль для подключения.

Руководство пользователя Oracle SQL Developer для получения дополнительной информации о создании, редактировании, экспорте и импорте соединений с базой данных.

Oracle Database Concepts для обзора многопользовательской архитектуры, представленной в Oracle Database 12c, которая позволяет базе данных Oracle функционировать как многопользовательская контейнерная база данных (CDB), которая включает ноль, одну или несколько подключаемых баз данных (PDB), созданных пользователем. . Не-CDB — это традиционная база данных Oracle, которая не может содержать PDB. Все базы данных Oracle до Oracle Database 12c не были CDB.

Руководство администратора базы данных Oracle для получения полной информации о создании и настройке CDB.

Читайте также: