Расширение SQLCLR для SQL Server с различными функциями для работы с информационными базами платформы 1С:Предприятие 8.x+. Базовый функционал расширения SQLCLR позволяет:

• Получить список баз 1С на SQL Server.
• Получить список таблиц базы 1С с расшифровкой имен в терминах прикладного решения платформы 1С.
• Получить список таблиц базы 1С с полями с расшифровкой имен в терминах прикладного решения платформы 1С.
• Получить список перечислений информационной базы 1С с расшифровкой их значений и порядка.
• Расшифровать внутренний формат данных 1С, хранящийся в двоичных данных, в читаемую (на сколько это возможно) строку.

Подробнее о возможностях и установки SQLCLR-расширения ниже.

Собранную DLL для установки расширения SQLCLR можно скачать в разделе релизы.

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

Новости по проектам или новым материалам в Telegram-канале.

SQLCLR расширение YellowMetadataReader базируется на решении Жичкина Дмитрия - dajet-metadata, которое изначально создавалось для чтения метаданных платформы 1С:Предприятие 8 напрямую из базы данных. Исходная версия поддерживает работу с SQL Server и PostgreSQL.

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

Вопросы автору DeJet можете задать в Telegram-канале.

Решение dajet-metadata было адаптировано под более узкие задачи:

• Переведено на платформу .NET Framework 4.8, т.к. SQLCLR базируется на работе именно этой среды выполнения CLR.
• Убрана поддержка PostgreSQL.
• Добавлено чтение некоторых служебных таблиц платформы 1С и распознавание их свойств (например, таблицы итогов регистров накопления, некоторые доп. поля для перечислений и констант и др.).

При этом сохранена в целом архитектура при работе с метаданными платформы 1С.

В текущей версии добавлен модуль EntryMetadata со следующими функциями.

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

SELECT * FROM [dbo].[fn_GetInfobases]()

При этом базы, не относящиеся к платформе 1С, в списке не отображаются. Может использоваться для поиска в скриптах баз 1С по имени конфигурации или версии, например, в скриптах обслуживания.

Получение списка таблиц информационной базы в терминах прикладного решения. Позволяет полу��ить список таблиц информционной базы 1С с маппингом имени таблицы SQL с именем таблицы в терминах прикладного решения. Пример вывода ниже.

SELECT * FROM [dbo].[fn_GetInfobaseTables]('BSL-ORIG')

Может использоваться как для скриптов обслуживания, так и для анализа базы данных в понятных терминах прикладного решения (например, занятого места по таблицам и так далее).

Получение списка таблиц с полями информационной базы в терминах прикладного решения. Позволяет получить список таблиц информционной базы 1С с маппингом имени таблицы SQL с именем таблицы в терминах прикладного решения, при этом для каждой таблицы выводится список полей в терминах SQL-базы и прикладного решения. Пример вывода ниже.

SELECT * FROM [dbo].[fn_GetInfobaseTablesWithFields]('BSL-ORIG')

Может использоваться как для скриптов обслуживания, так и для анализа базы данных в понятных терминах прикладного решения (например, занятого места по таблицам и так далее).

Получения списка перечислений информационной базы с их значениями в терминах прикладного решения. По умолчанию названия значений перечислений в базе данных в явном виде не хранятся. Данный методв позволяет получить к этой информации доступ без использования самой платформы 1С. Пример вывода ниже.

SELECT * FROM dbo.[fn_GetInfobasesEnumerations]('BSL-ORIG')
ORDER BY Enumeration, ValueOrder

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

Сервисная функция для преобразования двоичных данных внутреннего формата платформы 1С к читаемым (на сколько это возможно) строкам. Например, плафторма 1С хранит множество системных данных в базе в виде собственного формата. Данная функция позволит их прочитать в какой-то внятной ��орме.

SELECT [FileName]
	  ,[SQLServerMaintenance].dbo.fn_ParseInternalString(BinaryData) AS [FileDataAsString]
  FROM [BSL-ORIG].[dbo].[Params]
  WHERE FileName = 'DBNames'

{9063,
{5728,
{00000000-0000-0000-0000-000000000000,"SystemSettings",1},
{00000000-0000-0000-0000-000000000000,"CommonSettings",2},
{00000000-0000-0000-0000-000000000000,"RepSettings",3},
{00000000-0000-0000-0000-000000000000,"RepVarSettings",4},
...продолжение следует... |

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

Для окружение разработчика необходимы:

• .NET Framework 4.8 SDK
• .NET 6 SDK
• Visual Studio 2022
• Microsoft SQL Server 2012+
• Плафторма 1С 8.2 и новее.

Проекты и библиотеки в составе решения:

• Apps - различные приложения

  • YellowMetadataReader.CLI - пример приложения для работы с библиотекой.

• Libs - библиотеки и вспомогательные проекты.

  • YellowMetadataReader - проект библиотеки для расширения SQLCLR.

Для установки необходимо выполнить несколько шагов:

1. Собрать проект YellowMetadataReader в режиме Release.
2. Полученную DLL YellowMetadataReader.dll скопировать на сервер, где установлен экземпляр SQL Server. Пусть для примера путь к DLL на сервере будет "C:\Share\SQLCLR\YellowMetadataReader.dll".
3. Выбрать базу для установки. Например, пусть она называется SQLServerMaintenance.
4. Включим интеграцию с CLR. Для упрощения настройки опустим некоторые аспекты безопасности и разрешим установку неподписанных расширений.

EXEC sp_configure 'clr enabled', 1;  
RECONFIGURE;  
GO  
ALTER DATABASE SQLServerMaintenance SET TRUSTWORTHY ON;
GO

Также разрешим текущему пользователю доступ к внешним ресурсам. Например, это пользователь YY\ypermitin.

use [master]; GRANT EXTERNAL ACCESS ASSEMBLY TO [YY\ypermitin];

5. Если ранее расширение SQLCLR устанавливалось, то удалим все зарегистрированные функции и саму сборку перед повторной установкой.

DROP FUNCTION IF EXISTS [dbo].[fn_GetInfobases];
DROP FUNCTION IF EXISTS [dbo].[fn_GetInfobaseTables];
DROP FUNCTION IF EXISTS [dbo].[fn_GetInfobaseTablesWithFields];
DROP FUNCTION IF EXISTS [dbo].[fn_ParseInternalString];
DROP FUNCTION IF EXISTS [dbo].[fn_GetInfobasesEnumerations];
DROP ASSEMBLY IF EXISTS [YPermitin.SQLCLR.YellowMetadataReader];

6. Далее добавим сборку SQLCLR в базу SQLServerMaintenance.

USE [SQLServerMaintenance]
GO

CREATE ASSEMBLY [YPermitin.SQLCLR.YellowMetadataReader]
	FROM 'C:\Share\SQLCLR\YellowMetadataReader.dll'
	WITH PERMISSION_SET = UNSAFE;
GO

6. Теперь добавим все функции расширения, которые были описаны выше.

CREATE FUNCTION [dbo].[fn_GetInfobases]()  
RETURNS TABLE (
	InfobaseName nvarchar(255),
	ConfigVersion nvarchar(250),
	ConfigAlias nvarchar(250),
	ConfigName nvarchar(250),
	ConfigUiCompatibilityMode nvarchar(50),
	PlatformVersion nvarchar(50),
	InfobaseLastUpdate datetime null
)
AS   
EXTERNAL NAME [YPermitin.SQLCLR.YellowMetadataReader].[YPermitin.SQLCLR.YellowMetadataReader.EntryMetadata].[GetInfobases];  
GO  

CREATE FUNCTION [dbo].[fn_GetInfobaseTables](@databaseName nvarchar(255))  
RETURNS TABLE (
	TableSQL nvarchar(512),
	Table1C nvarchar(512)
)
AS   
EXTERNAL NAME [YPermitin.SQLCLR.YellowMetadataReader].[YPermitin.SQLCLR.YellowMetadataReader.EntryMetadata].[GetInfobaseTables];  
GO  

CREATE FUNCTION [dbo].[fn_GetInfobaseTablesWithFields](@databaseName nvarchar(255))  
RETURNS TABLE (
	TableSQL nvarchar(512),
	Table1C nvarchar(512),
	FieldSQL nvarchar(512),
	Field1C nvarchar(512)
)
AS   
EXTERNAL NAME [YPermitin.SQLCLR.YellowMetadataReader].[YPermitin.SQLCLR.YellowMetadataReader.EntryMetadata].[GetInfobaseTablesWithFields];  
GO  

CREATE FUNCTION [dbo].[fn_GetInfobasesEnumerations](@databaseName nvarchar(255))  
RETURNS TABLE (
	TableSQL nvarchar(512),
	Enumeration nvarchar(512),
	ValueId nvarchar(512),	
	ValueName nvarchar(512),
	ValueAlias nvarchar(512),
	ValueOrder int
)
AS   
EXTERNAL NAME [YPermitin.SQLCLR.YellowMetadataReader].[YPermitin.SQLCLR.YellowMetadataReader.EntryMetadata].[GetInfobasesEnumerations];  
GO  

CREATE FUNCTION [dbo].[fn_ParseInternalString](@data [varbinary](max))
RETURNS nvarchar(max) WITH EXECUTE AS CALLER
AS 
EXTERNAL NAME [YPermitin.SQLCLR.YellowMetadataReader].[YPermitin.SQLCLR.YellowMetadataReader.EntryMetadata].[ParseInternalString];  
GO

7. Все готово для использования.

USE [SQLServerMaintenance]
GO

SELECT * FROM [dbo].[fn_GetInfobases] ()
GO

-- BSL-ORIG - имя тестовой баз данных.
SELECT * FROM [dbo].[fn_GetInfobaseTables]('BSL-ORIG')
GO

SELECT * FROM [dbo].[fn_GetInfobaseTablesWithFields]('BSL-ORIG')
GO

SELECT * FROM dbo.[fn_GetInfobasesEnumerations]('BSL-ORIG')
ORDER BY Enumeration, ValueOrder
GO

Подробнее о настройках и разработке расширений SQLCLR можно найти материалы здесь.