Параметры форматирования
/add=<header>=<value | function>[;...]
Используйте эту опцию для добавления новых выходных столбцов с фиксированными значениями.
Например, файл AAPL.json содержит следующие столбцы:
Adjclose;Close;High;Low;Open;Timestamp;Volume
Выходной файл data.csv должен содержать следующие столбцы:
Symbol;Timestamp;Open;High;Low;Close;Volume;Adjclose
Чтобы добавить столбец Symbol, выполните команду:
gsqlcmd convert AAPL.json data.csv /append /add=Symbol=AAPL
Вы также можете использовать функции для получения имени файла в качестве значения:
gsqlcmd convert AAPL.json data.csv /append /add=Symbol=FileNameWithoutExtension()
Это позволяет конвертировать несколько входных файлов одной командой, например:
gsqlcmd convert *.json data.csv /append /add=Symbol=FileNameWithoutExtension()
gsqlcmd включает множество функций для решения типичных задач.
/addRowNum
Используйте эту опцию, чтобы добавить столбец с номером строки к выходным данным.
Укажите опцию /hasRowNum, чтобы использовать существующий первый столбец.
Используйте /addRowNum=false, чтобы удалить столбец с номером строки.
Также можно задать начальный номер строки с помощью опции /rowNumBase. Например:
/addRowNum /rowNumBase=1
/dateFormat=<format>
Эта опция позволяет указать формат значений даты.
Например:
/dateFormat=yyyy-MM-dd
/dateTimeFormat=<format>
Используйте эту опцию, чтобы указать формат значений даты и времени.
См. https://learn.microsoft.com/en-us/dotnet/api/system.datetime.tostring?view=net-8.0 для информации о форматных строках.
Используйте двойные кавычки для форматов, включающих пробелы. Например:
"/dateTimeFormat=yyyy-MM-dd hh:mm:ss"
/escapeChar=<char>
Эта опция позволяет установить символ, используемый для экранирования кавычек внутри строковых значений.
Например:
/escapeChar="
По умолчанию используется двойная кавычка. Укажите пустое значение, чтобы отключить экранирование.
См. https://datatracker.ietf.org/doc/html/rfc4180 для информации о формате CSV.
/lowerCase
Используйте эту опцию, чтобы преобразовать имена полей в строчные буквы в режимах make-fmt и make-create.
/noBOM
Эта опция запрещает добавление заголовка Unicode BOM к выходным данным.
/noHeaders
Используйте эту опцию, чтобы подавить вывод заголовков столбцов.
Например, следующая команда вернет чистый список URL-адресов из файла карты сайта:
gsqlcmd select "SELECT loc FROM https://www.gsqlcmd.com/sitemap.xml" /noHeaders
/noRound
Эта опция позволяет выводить числа со всеми десятичными знаками, как в источнике.
Без этой опции gsqlcmd округляет числа до двух или четырех знаков после запятой, если это не приводит к потере точности.
/outputCodePage=<codepage>
Эта опция позволяет определить кодовую страницу выходного файла.
Например:
/outputCodePage=65001
/outputCulture=<name>
Используйте эту опцию, чтобы определить культуру вывода, содержащую правила для форматирования значений даты, времени и чисел.
Например:
/outputCulture=en-GB
/[outputFormat=]asTxt | asText | asCsv | asHtm | asHtml | asXml | asJson
Эти параметры позволяют указать выходной формат.
Этот параметр можно опустить, если указать имя выходного файла с расширением *.txt, *.csv, *.htm, *.html, *.xml или *.json.
/[output]separator=<separator> | tab
Эта опция позволяет определить разделитель выходного CSV.
Например:
gsqlcmd select data.xml data.csv /separator=,
По умолчанию используется точка с запятой.
Используйте значение Tab, чтобы указать символ табуляции.
/quoteChar=<char>
Эта опция позволяет определить символ, используемый для обрамления строковых значений CSV в кавычки.
Например:
/quoteChar="
По умолчанию используется двойная кавычка. Укажите пустое значение, чтобы отключить обрамление.
См. https://datatracker.ietf.org/doc/html/rfc4180 для информации о формате CSV.
/relative
Эта опция позволяет удалить абсолютные пути в запросах BULK, сгенерированных в режиме make-bulk.
Microsoft SQL Server требует абсолютные пути, но вы можете использовать относительные пути, так как gsqlcmd расширяет их до абсолютных на лету.
/rowNumBase=<integer>
Эта опция позволяет определить номер первой строки вывода.
Используйте опцию /addRowNum, чтобы добавить в вывод столбец с номером строки.
Например:
/addRowNum /rowNumBase=1
По умолчанию значение равно 0.
/rowValues
Эта опция позволяет вывести данные XML и JSON в формате "ключ-значение".
Например, документ XML может содержать следующее:
<?xml version="1.0"?>
<root>
<row id="1">
<col1>Value11</col1>
<col2>Value12</col2>
</row>
<row id="2">
<col1>Value21</col1>
<col2>Value22</col2>
</row>
</root>
Обычная команда вернет следующий результат:
gsqlcmd select test.xml id col1 col2 1 Value11 Value12 2 Value21 Value22
Команда с параметром /rowValues вернет следующий результат:
gsqlcmd select test.xml /rowValues Key Value root.row.0.#id 1 root.row.0.col1 Value11 root.row.0.col2 Value12 root.row.1.#id 2 root.row.1.col1 Value21 root.row.1.col2 Value22
/timeFormat=<format>
Эта опция позволяет указать формат значений времени.
Например:
/timeFormat=hh:mm:ss
См. https://learn.microsoft.com/en-us/dotnet/api/system.datetime.tostring?view=net-8.0 для информации о форматных строках.
/upperCase
Используйте эту опцию, чтобы преобразовать имена полей в заглавные буквы в режимах make-fmt и make-create.
/xmlRoot=<name>
Эта опция позволяет изменить имя корневого узла в выводе XML.
/xmlRow=<name>
Эта опция позволяет изменить имя узла строки в выводе XML.