sqlclient.CodeFirst.InstallHisql();

var _sql = sqlClient.HiSql("select a.tabname from Hi_TabModel as a where a.tabname in (select b.tabname from Hi_FieldModel as b where b.tabname = `a.tabname`)").ToSql();

var _paramsql = sqlClient.HiSql(@"select * from Hi_FieldModel where tabname in (@TabName)  and fieldname=@fieldname and tabname in (select tabname from hi_tabmodel where tabname in (@TabName))", new { TabName = new List<string> { "Hi_TestQuery", "Hi_FieldModel" }, FieldName = "DbServer" }).ToSql();
Console.WriteLine(_paramsql);

void transDemo(HiSqlClient sqlClient)
{
    int count = 10;
    string tabname = typeof(H_Test02).Name;
    List<object> lstdata = buildData10Col(count);

    sqlClient.Delete(tabname).ExecCommand();

    using (var sqlClt = sqlClient.CreateUnitOfWork())
    { 
        sqlClt.Insert(tabname, lstdata).ExecCommand();

        sqlClt.Modi(tabname, lstdata).ExecCommand();
        sqlClt.CommitTran();
        //sqlClt.RollBackTran();
    }


}

string sql1= sqlClient.HiSql("select * from hi_tabmodel where tabname=@tabname ", new { TabName="H_test" ,FieldName="DID"}).ToSql();
string sql2= sqlClient.HiSql("select * from hi_tabmodel where tabname=@tabname or TabType in( @TabType)", new { TabName="H_test" , TabType =new List<int> { 1,2,3,4} }).ToSql();

string sql3 = sqlClient.HiSql("select * from hi_tabmodel where tabname=@tabname ", new Dictionary<string, object> { { "TabName", "H_test" } }).ToSql();

string sql4 = sqlClient.HiSql("select * from hi_tabmodel where tabname=[$tabname$] ", new Dictionary<string, object> { { "[$tabname$]", "H_test" } }).ToSql();

using (var client = sqlClient.CreateUnitOfWork())
{
    client.Insert("H_UType", new { UTYP = "U4", UTypeName = "高级用户" }).ExecCommand();

    //client.RollBackTran();
    

}

//возвращает структуру информации о результате этого запроса hisql
List<HiColumn> cols = sqlClient.HiSql("select max(FieldType) as fieldtype from Hi_FieldModel").ToColumns();

string sql = sqlClient.HiSql("select * from Hi_FieldModel as a where a.TabName=`a.TabName` and a.FieldName='11'").ToSql();

string sql = sqlClient.HiSql("select * from Hi_FieldModel as a where a.SortNum=`a.SortNum`+1 and a.FieldName='11'").ToSql();

string sql = sqlClient.Query("Hi_FieldModel", "A").Field("*")
    .Where(new Filter {
        {"A.TabName", OperType.EQ, "`A.FieldName`"}
                     })
    .Group(new GroupBy { { "A.FieldName" } }).ToSql();

string sql = sqlClient.Query("Hi_FieldModel", "A").Field("*")
    .Where(new Filter {
        {"A.SortNum", OperType.EQ, "`A.SortNum`+1"}
                     })
    .Group(new GroupBy { { "A.FieldName" } }).ToSql();

var sql = sqlClient.HiSql("select a.TabName, a.FieldName from Hi_FieldModel as a left join Hi_TabModel as b on a.TabName=b.TabName and a.TabName in ('H_Test') where a.TabName=b.TabName and a.FieldType>3 ").ToSql();

One or more errors occurred.(Unknow collation:'utf8mb4_0900_ai_ci')

Global.SnroOn = true;//указывает, что функция генерации номеров включена
sqlClient.CodeFirst.InstallHisql();//включает и инициализирует установку, автоматически создаст таблицу Hi_Snro во время установки


//добавляем конфигурацию генерации номеров
//SNRO представляет основное имя номера SNUM представляет идентификатор субномера
var obj1 = new { SNRO = "MATDOC", SNUM = 1, IsSnow=false, SnowTick=0, StartNum = "9000000", EndNum = "9999999",Length=7, CurrNum = "9000000", IsNumber = true, IsHasPre = false, CacheSpace = 10, Descript = "материальный основной номер данных" };


//добавить конфигурацию идентификатора снежинки
//SNRO представляет основное имя номера SNUM представляет идентификатор субномера
var obj2 = new { SNRO = "Order", SNUM = 1, IsSnow=true, SnowTick=145444, StartNum = "", EndNum = "",Length=7, CurrNum = "", IsNumber = true, IsHasPre = false, CacheSpace = 10, Descript = "номер заказа идентификатор снежинки" };

List<object> list = new List<object>();
list.Add(obj1);
list.Add(obj2);

sqlClient.Modi("Hi_Snro", list).ExecCommand();

public static SeriNumber number = null;  //определяем глобальную переменную для изменения номера

//sqlClient — это объект подключения к базе данных

``` **Текст запроса:**

Extension.TempType.STANDARD, DataBeginRow = 2, HeaderRow = 1 });
DataTable dt = excel.ExcelToDataTable(@"D:\data\GD_UniqueCodeInfo2.xlsx", true);

//OpLevel.Execute  — выполнение и возврат сгенерированного SQL
//OpLevel.Check — только проверка, сообщение о сбое возвращается при неудачной проверке, а при успешной проверке возвращается причина генерации SQL
HiColumn column = new HiColumn()
{
    TabName = "H_Test5",
    FieldName = "TestAdd",
    FieldType = HiType.VARCHAR,
    FieldLen = 50,
    DBDefault = HiTypeDBDefault.EMPTY,
    DefaultValue = "",
    FieldDesc = "Тестирование добавления поля"
};
var rtn= sqlClient.DbFirst.AddColumn("H_Test5", column, OpLevel.Execute);
if (rtn.Item1)
{
    Console.WriteLine(rtn.Item2);//сообщение об успешном выполнении
    Console.WriteLine(rtn.Item3);//сгенерированный SQL
}
else
    Console.WriteLine(rtn.Item2);//причина ошибки

//OpLevel.Execute — выполнение и возврат сгенерированного SQL
//OpLevel.Check — только проверка, сообщение о сбое возвращается при неудачной проверке, а при успешной проверке возвращается причина генерации SQL
HiColumn column = new HiColumn()
{
    TabName = "H_Test5",
    FieldName = "TestAdd",
    FieldType = HiType.VARCHAR,
    FieldLen = 51,
    DBDefault = HiTypeDBDefault.VALUE,
    DefaultValue = "TGM",
    FieldDesc = "Тестирование изменения поля"
};

var rtn = sqlClient.DbFirst.ModiColumn("H_Test5", column, OpLevel.Execute);
if (rtn.Item1)
{
    Console.WriteLine(rtn.Item2);//успешное выполнение
    Console.WriteLine(rtn.Item3);//сгенерированный SQL
}
else
    Console.WriteLine(rtn.Item2);//ошибка

//OpLevel.Execute — выполнение и возврат сгенерированного SQL
//OpLevel.Check — только проверка, сообщение о сбое возвращается при неудачной проверке, а при успешной проверке возвращается причина генерации SQL
HiColumn column = new HiColumn()
{
    TabName = "H_Test5",
    FieldName = "Testname3",
    ReFieldName = "Testname2",
    FieldType = HiType.VARCHAR,
    FieldLen = 50,
    DBDefault = HiTypeDBDefault.VALUE,
    DefaultValue = "TGM",
    FieldDesc = "Переименование поля для тестирования"
};

var rtn = sqlClient.DbFirst.ReColumn("H_Test5", column, OpLevel.Execute);
if (rtn.Item1)
{
    Console.WriteLine(rtn.Item2);//успешное выполнение
    Console.WriteLine(rtn.Item3);//сгенерированный SQL
}
else
    Console.WriteLine(rtn.Item2);//ошибка

//OpLevel.Execute — выполнение и возврат сгенерированного SQL
//OpLevel.Check — только проверка, сообщение о сбое возвращается при неудачной проверке, а при успешной проверке возвращается причина генерации SQL
HiColumn column = new HiColumn()
{
    TabName = "H_Test5",
    FieldName = "TestAdd",
    FieldType = HiType.VARCHAR,
    FieldLen = 51,
    DBDefault = HiTypeDBDefault.VALUE,
    DefaultValue = "TGM",
    FieldDesc = "Тестирование изменения поля"
};

var rtn = sqlClient.DbFirst.ModiColumn("H_Test5", column, OpLevel.Execute);
if (rtn.Item1)
{
    Console.WriteLine(rtn.Item2);//успешное выполнение
    Console.WriteLine(rtn.Item3);//сгенерированный SQL
}
else
    Console.WriteLine(rtn.Item2);//ошибка

//OpLevel.Execute — выполнение и возврат сгенерированного SQL
//OpLevel.Check — только проверка, сообщение о сбое возвращается при неудачной проверке, а при успешной проверке возвращается причина генерации SQL
var tabinfo = sqlClient.Context.DMInitalize.GetTabStruct("H_Test5");

TabInfo _tabcopy = ClassExtensions.DeepCopy<TabInfo>(tabinfo);
_tabcopy.Columns[2].ReFieldName = "Testname3";
var rtn= sqlClient.DbFirst.ModiTable(_tabcopy, OpLevel.Execute);
if (rtn.Item1)
{
    Console.WriteLine(rtn.Item2);//успешное выполнение
    Console.WriteLine(rtn.Item3);//сгенерированный SQL
}
else
    Console.WriteLine(rtn.Item2);//ошибка

//Получение всех физических таблиц текущей базы данных
List<TableInfo> lsttales = sqlClient.DbFirst.GetAllTables();
foreach (TableInfo tableInfo in lsttales)
{
    Console.WriteLine($"{tableInfo.TabName} {tableInfo.TabReName} {tableInfo.TabDescript} {tableInfo.TableType} структура таблицы:{tableInfo.HasTabStruct}");
}

//Получение глобальных временных таблиц текущей базы данных
List<TableInfo> lsttales = sqlClient.DbFirst.GetGlobalTempTables();
foreach (TableInfo tableInfo in lsttales)
{
    Console.WriteLine($"{tableInfo.TabName} {tableInfo.TabReName} {tableInfo.TabDescript} {tableInfo.TableType} структура таблицы:{tableInfo.HasTabStruct}");
}

//OpLevel.Execute — выполнение и возврат сгенерированного SQL
//OpLevel.Check — только проверка, сообщение о сбое возвращается при неудачной проверке, а при успешной проверке возвращается причина генерации SQL
var rtn = sqlClient.DbFirst.CreateView("vw_FModel", 
sqlClient.HiSql("select a.TabName,b.TabReName,b.TabDescript,a.FieldName,a.SortNum,a.FieldType from Hi_FieldModel as a inner join Hi_TabModel as b on a.TabName=b.TabName").ToSql(), 
OpLevel.Execute);

if (rtn.Item1)
{
    Console.WriteLine(rtn.Item2);//успешное создание
    Console.WriteLine(rtn.Item3);//сгенерированный SQL
}
else
    Console.WriteLine(rtn.Item2);//ошибка создания

//OpLevel.Execute — выполнение и возврат сгенерированного SQL
``` **Текст запроса:**

```c#
//在表中添加用户类型 Modi方法的意思是 如果存在则更新没有则插入
            sqlClient.Modi("H_UType", new List<object> {
                new { UTYP = "U1", UTypeName = "普通用户" },
                new { UTYP = "U2", UTypeName = "中级用户" },
                new { UTYP = "U3", UTypeName = "高级用户" }
            }).ExecCommand();

// 增加表校验配置
sqlClient.Update("Hi_FieldModel", new { TabName = "HTest01", FieldName = "UTYP", IsRefTab=true,RefTab= "H_UType",RefField="UTYP", RefFields = "UTYP,UTypeName",RefFieldDesc= "类型编码,类型名称",RefWhere="UTYP<>''" }).ExecCommand();

//执行数据插入
sqlClient.Insert("HTest01", new { SID = "0", UTYP = "U4", UName = "hisql", Age = 36, Salary = 11, Descript = "hisql" }).ExecCommand();

2.2 字符串写法如下所示
支持 字符串写法解决通过应用前端可以自定义传条件过来 `a.tabname = 'Hi_FieldModel' and ((a.FieldType = 11)) `
看这个语法类似于sqlserver的写法，与sqlserver无关， 这是Hisql自定义的中间语法 通过hisql编译后在hisql支持的库中运行

注：暂时不支持in,not in写法 下一版本将会加上


```c#
string jsondata = sqlClient.Query("Hi_FieldModel", "A").Field("A.FieldName as Fname")
    .Join("Hi_TabModel").As("B").On(new JoinOn { { "A.TabName", "B.TabName" } })
    .Where("a.tabname = 'Hi_FieldModel' and ((a.FieldType = 11)) ")
    .Group(new GroupBy { { "A.FieldName" } }).ToJson();

2. **Массовая вставка данных**

    Для работы с таблицами не нужно использовать сущности, как в других фреймворках. HiSql позволяет работать без сущностей, но если вы привыкли к ним, то можете их использовать.

    ```c#
    int _times = 100000;
    List<object> lstobj = new List<object>();
    for (int i = 0; i < _times; i++)
    {
        lstobj.Add(new { Domain = $"{i}", DomainDesc = $"用户类型{i}" });

    }
    sqlclient.Insert("Hi_Domain", new { Domain = "UTYPE", DomainDesc = "用户类型" }).ExecCommand();
    ```
---

3. **Обновление или вставка данных в зависимости от наличия записи**
   Часто в бизнес-разработке возникают ситуации, когда необходимо обновить данные, если запись существует, и вставить данные, если её нет. Обычно это делается с помощью хранимых процедур или отдельных SQL-запросов. Однако HiSql предоставляет более удобный способ:

   *Примечание: если первичный ключ таблицы является автоинкрементным идентификатором, то эта функция не будет работать.*

    ```c#
    //Если запись существует, она будет обновлена, иначе — вставлена. Поддерживает массовую операцию
     sqlClient.Modi("H_Test", new { Hid = 1, UserName = "tansar", UserAge = 100, ReName = "Tom" }).ExecCommand();



    ```
### Запрос данных из таблицы

1. **Запрос одной таблицы**
    
    Результаты запроса можно преобразовать в таблицу ToTable, в JSON ToJson, в список ToList или в динамический объект ToDynamic. В этом примере показано использование ToTable.
    1. Запрос возвращает DataTable. Здесь также используется сортировка.
        ```c#
        DataTable DT_RESULT1= sqlclient.Query("DataDomain").Field("Domain").Sort(new SortBy { { "createtime" } }).ToTable();
        ```

        Определение псевдонимов для таблицы.
        ```c#
        DataTable DT_RESULT2 = sqlclient.Query("DataDomain").As("a").Field("a.Domain").Sort(new SortBy { { "a.createtime" } }).ToTable();
        ```
    2. Запрос возвращает список объектов. В методе Field() передаётся "*", чтобы получить все поля таблицы.

        ```c#
        List<Hi_Domain> lstefresult = sqlclient.Query("Hi_Domain").Field("*").Sort("createtime asc", "moditime").ToList<Hi_Domain>();

        ```
    3. Запрос с использованием разбивки на страницы.
        ```c#
        DataTable DT_RESULT3 = sqlclient.Query("DataDomain").As("a").Field("a.Domain").Sort(new SortBy { { "a.createtime" } }).Skip(1).Take(100).ToTable();

        ```

2. **Простой запрос с объединением нескольких таблиц**

    1. Объединение двух таблиц и применение условий фильтрации и разбивки на страницы:
        ```c#
        DataTable DT_RESULT = sqlclient.Query("Hi_FieldModel", "A").Field("A.FieldName as Fname")
                    .Join("Hi_TabModel").As("B").On(new JoinOn { { "A.TabName", "B.TabName" } }) 
                    .Where(new Filter {
                        {"A.TabName", OperType.EQ, "Hi_FieldModel"},
                        {"A.FieldType",OperType.BETWEEN,new RangDefinition(){ Low=10,High=99} },
                    })
                    .Skip(1).Take(10).ToTable();
        ```
    2. Реализация запроса с группировкой group by:

        ```c#
        DataTable DT_RESULT = sqlclient.Query("Hi_FieldModel", "A").Field("A.FieldName as Fname")
                .Join("Hi_TabModel").As("B").On(new JoinOn { { "A.TabName", "B.TabName" } }) 
                .Where(new Filter {
                    {"A.TabName", OperType.EQ, "Hi_FieldModel"},
                    {"A.FieldType",OperType.BETWEEN,new RangDefinition(){ Low=10,High=99} },
                })
                .Group(new GroupBy { { "A.FieldName" } })
                .ToTable();
        ```
    3. Выполнение запроса с использованием статистических функций:

        ```c#
        DataTable dt_resultfun = sqlclient.Query("Hi_FieldModel", "A").Field("A.FieldName    as    Fname", "count(*) as avgFieldLen")
                .Join("Hi_TabModel").As("B").On(new JoinOn { { "A.TabName", "B.TabName" } })
                .Where(new Filter {
                    {"A.TabName", OperType.EQ, "Hi_FieldModel"},
                    {"A.FieldType",OperType.BETWEEN,new RangDefinition(){ Low=10,High=99} },

                })
                .Group(new GroupBy { { "A.FieldName" } })
                .ToTable();
        ```

        Поддерживаемые функции:

        - count  образец count(*) as scount
        - avg образец avg("score") as avgscore  *примечание:* score должно быть числовым значением, иначе HiSql выдаст ошибку
        - sum образец sum("score") as sumscore  *примечание:* score должно быть числовым значением, иначе HiSql выдаст ошибку
        - min образец min("score")  as minscore 
        - max образец max("score") as maxscore

    4. Объединение нескольких таблиц с применением разбивки на страницы:

        Можно выполнять разбивку на страницы для данных, полученных после объединения таблиц.
        ```c#
        DataTable dt_resultfun = sqlclient.Query("Hi_FieldModel", "A").Field("A.FieldName    as    Fname", "count(*) as avgFieldLen")
                .Join("Hi_TabModel").As("B").On(new JoinOn { { "A.TabName", "B.TabName" } })
                .Where(new Filter {
                    {"A.TabName", OperType.EQ, "Hi_FieldModel"},
                    {"A.FieldType",OperType.BETWEEN,new RangDefinition(){ Low=10,High=99} },

                })
                .Group(new GroupBy { { "A.FieldName" } })

``` 3. Сложный запрос с объединением подзапросов и использованием UNION ALL:

```c#
DataTable dt_resultuinon = sqlclient.Query(
    sqlclient.Query("Hi_FieldModel").Field("*").Where(new Filter { { "TabName", OperType.IN,
        sqlclient.Query("Hi_TabModel").Field("TabName").Where(new Filter { {"TabName",OperType.IN,new List<string> { "Hone_Test", "H_TEST" } } })
    } }),
    sqlclient.Query("Hi_FieldModel").Field("*").Where(new Filter { { "TabName", OperType.EQ, "DataDomain" } }),
    sqlclient.Query("Hi_FieldModel").Field("*").Where(new Filter { { "TabName", OperType.EQ, "Hi_FieldModel" } })
)
    .Field("TabName", "count(*) as CHARG_COUNT")
    .Group(new GroupBy { { "TabName" } }).ToTable();

DataTable dt_resultuinon = sqlclient.Query(
    sqlclient.Query("Hi_FieldModel").Field("*").Where(new Filter { { "TabName", OperType.IN,
        sqlclient.Query("Hi_TabModel").Field("TabName").Where(new Filter { {"TabName",OperType.IN,new List<string> { "Hone_Test", "H_TEST" } } })
    } }),
    sqlclient.Query("Hi_FieldModel").Field("*").Where(new Filter { { "TabName", OperType.EQ, "DataDomain" } }),
    sqlclient.Query("Hi_FieldModel").Field("*").Where(new Filter { { "TabName", OperType.EQ, "Hi_FieldModel" } })
)
    .Field("TabName", "count(*) as CHARG_COUNT")
    .WithRank(DbRank.DENSERANK, DbFunction.NONE, "TabName", "rowidx1", SortType.ASC)
    .WithRank(DbRank.ROWNUMBER, DbFunction.COUNT, "*", "rowidx2", SortType.ASC)
    .WithRank(DbRank.RANK, DbFunction.COUNT, "*", "rowidx3", SortType.ASC)
    .Group(new GroupBy { { "TabName" } }).ToTable();

DataTable dt= sqlClient.Context.DBO.GetDataTable("select * from dbo.Hi_FieldModel where TabName in (:TabName)", new HiParameter(":TabName",new List<string> { "Hi_TabModel", "Hi_FieldModel" }));

DataTable dt = sqlClient.Context.DBO.GetDataTable("select * from dbo.Hi_FieldModel where TabName = @TabName", new HiParameter("@TabName", "Hi_TabModel"));

int _effect = sqlClient.Update("H_TEST", new { DID = 1, UNAME = "UTYPE", UNAME2 = "user123" }).Exclude("UNAME").ExecCommand();

update [dbo].[H_TEST] set [UNAME2]='user123' where [DID]=1

int _effect1 = sqlClient.Update("H_TEST").Set(new { UNAME2 = "TEST" }).Where(new Filter { { "DID", OperType.GT, 8 } }).ExecCommand();

update [dbo].[H_TEST] set [UNAME2]='TEST' where [H_TEST].[DID] > 8

class H_Test
{ 
    public int DID {
        get;set;
    }
    public string UNAME {
        get;set;
    }
    public string UNAME2
    {
        get;set;
    }
}

int _effect2 = sqlClient.Update<H_Test>(new H_Test { DID = 1, UNAME2 = "Haha1" }).Only("UNAME2").ExecCommand();

update [dbo].[H_Test] set [UNAME2]='Haha1' where [DID]=1

int _effect3 = sqlClient.Update("H_TEST", new List<object> { new { DID = 1, UNAME2 = "user123" }, new { DID = 2, UNAME2 = "user124" } }).Only("UNAME2").ExecCommand();

update [dbo].[H_TEST] set [UNAME2]='user123' where [DID]=1
update [dbo].[H_TEST] set [UNAME2]='user124' where [DID]=2

int _effect = sqlClient.Delete("H_Test").ExecCommand();

delete [dbo].H_Test
``` **Удаление данных из таблицы в базе данных**

1. Удаление данных, соответствующих определённому условию:

    ```c#
    int _effect1 = sqlClient.Delete("H_Test").Where(new Filter { { "DID", OperType.GT, 200 } }).ExecCommand();
    ```

    SQL-запрос:

    ```sql
    delete [dbo].H_Test where [H_Test].[DID] > 200
    ```

2. Удаление без сущности данных по основному ключу:

    ```c#
    int _effect3 = sqlClient.Delete("H_Test", new List<object> { new { DID = 99, UNAME2 = "user123" }, new { DID = 100, UNAME2 = "user124" } }).ExecCommand();
    ```

    SQL-запросы:

    ```sql
    delete [dbo].H_Test where [DID]=99
    delete [dbo].H_Test where [DID]=100
    ```

3. Удаление с сущностью данных по основному ключу:

    ```c#
    class H_Test
    {
        public int DID
        {
            get; set;
        }
        public string UNAME
        {
            get; set;
        }
        public string UNAME2
        {
            get; set;
        }

    }
    ```

    ```c#
    int _effect4 = sqlClient.Delete("H_Test", new List<H_Test> { new H_Test { DID = 99, UNAME2 = "user123" }, new H_Test { DID = 100, UNAME2 = "user124" } }).ExecCommand();

    ```

    SQL-запросы:

    ```sql
    delete [dbo].H_Test where [DID]=99
    delete [dbo].H_Test where [DID]=100
    ```

4. Удаление данных без журнала базы данных:

    ```c#
    int _effect5 = sqlClient.TrunCate("H_Test").ExecCommand();
    ```

    SQL-запрос:

    ```sql
    TRUNCATE TABLE [dbo].H_Test
    ```

**Реализация case-оператора в HiSql**

HiSql предоставляет удобный способ работы с case-оператором в SQL, который автоматически адаптируется под различные базы данных. Разработчикам не нужно беспокоиться о конкретных синтаксических различиях между базами данных.

Пример кода на C#:

```c#
string _sql=sqlClient.Query("Hi_TabModel").Field("TabName as tabname").
    Case("TabStatus")
        .When("TabStatus>1").Then("'启用'")
        .When("0").Then("'未激活'")
        .Else("'未启用'")
    .EndAs("Tabs", typeof(string))
    .Field("IsSys")
    .ToSql()
    ;