MsSqlDataProvider - Провайдер для базы данных MSSQLServer

class axipy.MsSqlDataProvider

Базовые классы: DataProvider

Провайдер для Базы Данных MSSQLServer.

Примечание

Для работы с СУБД Microsoft SQL Server необходимо скачать и установить Microsoft SQL Server Native Client.

См. Руководство по установке и активации.

Примечание

Ссылку на провайдер можно получить через глобальную переменную axipy.provider_manager.mssql.

Свойства:

id

Идентификатор провайдера.

Методы:

create_open(*args, **kwargs)

Создает и открывает объект данных.

file_extensions()

Список поддерживаемых расширений файлов.

get_destination()

Создает назначение объекта данных.

get_source(host, db_name, user, password[, ...])

Создает описательную структуру для источника данных.

open(host, db_name, user, password[, port, ...])

Открывает объект данных.
create_open(*args, **kwargs)

Создает и открывает объект данных.

Пример:

provider.create_open(...)

Что эквивалентно:

provider.get_destiantion(...).create_open()

См.также

DataProvider.destination().

file_extensions() → List[str]

Список поддерживаемых расширений файлов.

Результат:

Пустой список для не файловых провайдеров.

get_destination() → Destination

Создает назначение объекта данных.

Исключение:

NotImplementedError – Если провайдер не поддерживает создание назначений.

get_source(host: str, db_name: str, user: str, password: str, port: int = 1433, dataobject: Optional[str] = None, sql: Optional[str] = None, alias: Optional[str] = None) → Source

Создает описательную структуру для источника данных. Она в дальнейшем может быть использована при открытии данных ProviderManager.open().

Примечание

В качестве таблицы можно указать либо ее наименование dataobject либо текст запроса sql.

Примечание

Ссылку на провайдер можно получить через глобальную переменную axipy.provider_manager.mssql.

Параметры:

  • host – Адрес сервера.

  • db_name – Имя базы данных.

  • user – Имя пользователя.

  • password – Пароль.

  • port – Порт.

  • dataobject – Имя таблицы.

  • sql – SQL-запрос. Если указан, то он имеет более высокий приоритет по отношению к значению dataobject.

Пример с указанием имени таблицы:

definition = provider_manager.mssql.get_source('localhost', 'test', 'sa', 'sa', dataobject='world')
table = provider_manager.open(definition)

Пример с указанием текста запроса:

definition = provider_manager.mssql.get_source('localhost', 'test', 'sa', 'sa', sql="select * from world where Страна like 'Р%'")
table = provider_manager.open(definition)
property id: str

Идентификатор провайдера.

open(host: str, db_name: str, user: str, password: str, port: int = 1433, dataobject: Optional[str] = None, sql: Optional[str] = None, alias: Optional[str] = None) → Table

Открывает объект данных.

Примечание

В качестве таблицы можно указать либо ее наименование dataobject либо текст запроса sql.

Параметры:

  • host – Адрес сервера.

  • db_name – Имя базы данных.

  • user – Имя пользователя.

  • password – Пароль.

  • port – Порт.

  • dataobject – Имя таблицы.

  • sql – SQL-запрос. Если указан, то он имеет более высокий приоритет по отношению к значению dataobject.

  • alias – Псевдоним для открываемой таблицы.