Параметры форматирования

Параметры форматирования

/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.

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