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

Обновлено: 21.11.2024

Например, чтобы скопировать файл с именем yearly-report.mov из c:\reports в общую папку \\marketing\videos при включении многопоточности для повышения производительности (с параметром /mt) и возможности перезапустить передачу в случае ее прерывания (с параметром /z), введите:

Параметры

Параметр	Описание
Указывает путь к исходному каталогу.
Указывает путь к целевому каталогу.
Указывает файл или файлы для копирования. Подстановочные знаки (* или ?) поддерживаются. Если этот параметр не указан, в качестве значения по умолчанию используется ..
Указывает параметры, используемые с командой robocopy, включая копирование, файл, повторную попытку, ведение журнала и параметры задания.

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

D – Данные
А – Атрибуты
T – метки времени
S — список управления доступом (ACL) NTFS
O – информация о владельце.
U – Информация об аудите

D – Данные
А – Атрибуты
T – метки времени

R — только чтение
А – Архив
S – Система
H – скрыто
С – сжатый
N — контент не проиндексирован
E — зашифровано
T – временно

R — только чтение
А – Архив
S – Система
H – скрыто
С – сжатый
N — контент не проиндексирован
E — зашифровано
T – временно

При использовании параметра копирования /secfix укажите тип информации о безопасности, которую вы хотите скопировать, с помощью одного из следующих дополнительных параметров копирования:

Параметры выбора файла

R — только чтение
А – Архив
S – Система
H – скрыто
С – сжатый
N — контент не проиндексирован
E — зашифровано
T – временно
O – офлайн

R — только чтение
А – Архив
S – Система
H – скрыто
С – сжатый
N — контент не проиндексирован
E — зашифровано
T – временно
O – офлайн

Параметры повторной попытки

Опция	Описание
/r:	Указывает количество попыток неудачных копий. Значение по умолчанию n равно 1 000 000 (один миллион повторных попыток).
/w:	указывает время ожидания между повторными попытками. , в секундах. Значение по умолчанию n равно 30 (время ожидания 30 секунд).
/reg	Сохраняет значения, указанные в Параметры /r и /w в качестве настроек по умолчанию в реестре.
/tbd	Указывает, что система будет ожидать определения имен общих ресурсов (повторить ошибка 67).

Параметры ведения журнала

< tr>

Option	Description
/l	Указывает, что файлы должны быть только перечислены (а не скопированы, удалены или проставлены метки времени).
/x	Сообщает обо всех дополнительных файлах, а не только о тех, которые выбраны.
/v	Производит подробный вывод и показывает все пропущенные файлы.
/ts	Включает в вывод временные метки исходного файла.
/fp	Включает полные пути к файлам в вывод.
/bytes	Выводит размеры в байтах.
/ns	Указывает, что размеры файлов не должны регистрироваться.
/nc	Указывает, что классы файлов не должны регистрироваться.
/nfl	Указывает, что имена файлов не должны регистрироваться.
/ndl	Указывает, что имена каталогов не должны регистрироваться.
/np	Указывает, что ход операции копирования (n количество скопированных файлов или каталогов) не будет отображаться.
/eta	Показывает предполагаемое время прибытия (ETA) скопированных файлов .
/log:	Записывает вывод состояния в файл журнала (перезаписывает существующий файл журнала).
/log+:	Записывает вывод состояния в файл журнала (добавляет вывод в существующий файл журнала).
/unicode	Отображает вывод состояния в виде текста Unicode.
/unilog:	Записывает вывод состояния в файл журнала в виде текста Unicode. (перезаписывает существующий файл журнала).
/unilog+:	Записывает вывод состояния в файл журнала в виде текста Unicode (добавляет вывод к существующему файл журнала).
/tee	Записывает вывод состояния в окно консоли, а также в файл журнала.
/njh	Указывает, что заголовок задания отсутствует.
/njs	Указывает, что резюме задания отсутствует.

Варианты работы

< /tr>

Опция	Описание
/job:	Указывает что параметры должны быть получены из именованного файла задания.
/save:	Указывает, что параметры должны быть сохранены в именованном файле задания.< /td>
/quit	Выход после обработки командной строки (для просмотра параметров).
/nosd< /td>	Указывает, что исходный каталог не указан.
/nodd	Указывает, что не указан целевой каталог.
/if	Включает указанные файлы.

Коды выхода (возврата)

Значение	Описание
0	Файлы не скопировано. Сбоев не встречалось. Нет несоответствий файлов. Файлы уже существуют в целевом каталоге; поэтому операция копирования была пропущена.
1	Все файлы успешно скопированы.
2	В целевом каталоге есть несколько дополнительных файлов, которых нет в исходном каталоге. Файлы не были скопированы.
3	Некоторые файлы были скопированы. Присутствовали дополнительные файлы. Сбоев не было.
5	Некоторые файлы были скопированы. Некоторые файлы не совпадают. Сбоев не обнаружено.
6	Существуют дополнительные файлы и несоответствующие файлы. Файлы не копировались, сбоев не было. Это означает, что файлы уже существуют в целевом каталоге.
7	Файлы были скопированы, имело место несоответствие файлов и присутствовали дополнительные файлы.
8	Несколько файлов не скопированы.

Любое значение больше 8 означает, что во время операции копирования произошла по крайней мере одна ошибка.

Вместо того, чтобы передавать параметры как встроенные значения в ваш скрипт, вы можете использовать файл JSON, содержащий значения параметров. В этой статье показано, как создать файл параметров, который вы используете с шаблоном JSON.

Мы рекомендуем Bicep, поскольку он предлагает те же возможности, что и шаблоны ARM, а его синтаксис проще в использовании. Чтобы узнать больше, см. файлы параметров.

Файл параметров

Файл параметров имеет следующий формат:

Обратите внимание, что файл параметров хранит значения параметров в виде обычного текста. Этот подход работает для значений, которые не являются конфиденциальными, например для SKU ресурса. Обычный текст не подходит для конфиденциальных значений, таких как пароли. Если вам нужно передать параметр, содержащий конфиденциальное значение, сохраните значение в хранилище ключей. Затем укажите ссылку на хранилище ключей в файле параметров. Конфиденциальное значение безопасно извлекается во время развертывания.

Следующий файл параметров содержит простое текстовое значение и конфиденциальное значение, хранящееся в хранилище ключей.

Дополнительные сведения об использовании значений из хранилища ключей см. в статье Использование Azure Key Vault для передачи безопасного значения параметра во время развертывания.

Определить значения параметров

Чтобы определить, как определить имена и значения параметров, откройте свой шаблон JSON и просмотрите раздел параметров. В следующем примере показаны параметры шаблона JSON.

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

Обратите внимание на тип параметра. Типы параметров в вашем файле параметров должны использовать те же типы, что и в вашем шаблоне. В этом примере оба типа параметров являются строками.

Проверьте шаблон на наличие параметров со значением по умолчанию. Если параметр имеет значение по умолчанию, вы можете указать значение в файле параметров, но это не обязательно. Значение файла параметров переопределяет значение шаблона по умолчанию.

Проверьте допустимые значения шаблона и любые ограничения, такие как максимальная длина. Эти значения определяют диапазон значений, которые вы можете указать для параметра. В этом примере storagePrefix может иметь не более 11 символов, а storageAccountType должен указывать допустимое значение.

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

Форматы типов параметров

В следующем примере показаны форматы различных типов параметров: строка, целое число, логическое значение, массив и объект.

Развернуть шаблон с файлом параметров

Из Azure CLI вы передаете локальный файл параметров, используя @ и имя файла параметров. Например, @storage.parameters.json .

Из Azure PowerShell вы передаете локальный файл параметров, используя параметр TemplateParameterFile.

Невозможно использовать файл параметров с колонкой пользовательского шаблона на портале.

Если вы используете проект Azure Resource Group в Visual Studio, убедитесь, что в файле параметров для параметра Действие сборки задано значение Контент.

Имя файла

Общее соглашение об именах для файла параметров заключается в том, чтобы включать параметры в имя шаблона. Например, если ваш шаблон называется azuredeploy.json, ваш файл параметров будет называться azuredeploy.parameters.json. Это соглашение об именах помогает увидеть связь между шаблоном и параметрами.

Для развертывания в разных средах необходимо создать несколько файлов параметров. Когда вы называете файлы параметров, укажите их использование, например, разработку и производство. Например, используйте azuredeploy.parameters-dev.json и azuredeploy.parameters-prod.json для развертывания ресурсов.

Приоритет параметра

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

Можно использовать внешний файл параметров, указав URI для файла. Когда вы используете внешний файл параметров, вы не можете передавать другие значения как встроенные, так и из локального файла. Все встроенные параметры игнорируются. Укажите все значения параметров во внешнем файле.

Конфликты имен параметров

Если ваш шаблон включает параметр с тем же именем, что и один из параметров в команде PowerShell, PowerShell представляет параметр из вашего шаблона с постфиксом FromTemplate . Например, параметр с именем ResourceGroupName в вашем шаблоне конфликтует с параметром ResourceGroupName в командлете New-AzResourceGroupDeployment. Вам будет предложено указать значение для ResourceGroupNameFromTemplate . Чтобы избежать путаницы, используйте имена параметров, которые не используются для команд развертывания.

Параметр include указывает файлы LookML, которые будут доступны для модели, представления или исследования. Если вы хотите использовать файл LookML или ссылаться на него в другом файле, вы должны добавить его с параметром include.

Вы можете использовать параметр include в файлах моделей, файлах просмотра и файлах исследования. Параметр include может ссылаться на разные типы файлов LookML в зависимости от контекста.

В файле модели вы можете использовать include для ссылки:

В файле представления вы можете использовать include для ссылки:

В файле исследования вы можете использовать включение для ссылки:

Вы также можете использовать include для загрузки файлов из других проектов. См. страницу документации Импорт файлов из других проектов для получения информации о включении файлов из другого проекта. Чтобы импортировать файлы из локальных проектов LookML, необходимо включить функцию «Лаборатория импорта локальных проектов».

При использовании include обратите внимание на следующее:

Вам не нужно использовать include для типов файлов, отличных от LookML, таких как файлы документации или файлы данных.
Включать файлы можно по принципу "все или ничего", поэтому вся информация о включаемомвключаемом файле добавляется во включаемый файлвключаемый.
В файле можно использовать несколько параметров включения.
Вы можете использовать подстановочный знак * для обозначения файлов со стратегическими соглашениями об именах или с тем же расширением. Например, вы можете использовать «*base.dashboard» для сопоставления и включения как «database.dashboard», так и «crunchbase.dashboard». Вы можете использовать "*.dashboard" для обозначения всех файлов с расширением .dashboard .
Вы можете использовать подстановочный знак *, чтобы включить все файлы в каталоге. Например, вы можете включить все файлы представлений в каталог views/users/, указав include: "/views/users/*.view" . Дополнительную информацию об использовании подстановочных знаков с папками IDE см. на странице документации по папкам IDE.

Полезный совет: при использовании подстановочных знаков вы можете проверить, какие файлы включены, наведя указатель мыши на значок информации на панели изменений файла или щелкнув оператор включения и просмотрев краткую справку:

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

Включение представлений и информационных панелей в модель

Используйте параметр include в файле модели, чтобы указать панель мониторинга и файлы просмотра, которые будут доступны для этой модели. Если вы хотите использовать или ссылаться на файл LookML в модели, вы должны добавить его с параметром include.

В параметре include используйте расширение .view для файлов представлений и расширение .dashboard для информационных панелей. Вы можете опустить части .lkml и .lookml этих расширений.

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

Например, вы можете использовать следующие включаемые параметры в файле модели:

Эти параметры включают следующие файлы:

Все файлы панели мониторинга в любом каталоге вашего проекта
Любые файлы представлений, оканчивающиеся на base.view.lkml, в любом непосредственном дочернем каталоге проекта, например /views/database.view.lkml или /public/crunchbase.view.lkml
Все файлы представлений в каталоге /views/ импортированного проекта с именем e_commerce

Если в вашем проекте большое количество файлов представлений или если в вашем проекте используются постоянные производные таблицы (PDT), вам следует избегать включения в модель всех файлов представлений. Вместо этого включите отдельные файлы представлений, подобные этому. Вот пример включения отдельных файлов представлений и всех информационных панелей в проект:

Включение моделей в модель

Вы не можете включить файл модели из другого проекта. Вместо этого, если вы хотите повторно использовать, уточнять или расширять исследования в разных проектах, в импортированном проекте вы можете создать отдельный файл исследования, а затем включить этот файл исследования в другие проекты. Дополнительную информацию см. в разделе «Включение исследований в модель».

Включение исследований в модель

Файлы исследования будут прослушивать соединение модели, в которую они включены. Учтите этот факт, когда вы включаете файлы исследования в модели, для которых настроено соединение, отличное от родительской модели файла исследования. Если схема подключения включающей модели отличается от схемы подключения родительской модели, это может привести к ошибкам запроса.

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

Если у вас есть отдельный файл исследования, вам нужно использовать параметр include в файле модели, чтобы включить его. В параметре include используйте расширение .explore.lkml для файлов Explore.

Например, ниже приведен файл модели с двумя исследованиями:

Исследуемый самолет_новый, который определен в собственном файле с именем самолета_новый.эксплор.лкмл в папке исследования. Поскольку этот файл Explore определен в собственном файле, вы должны указать путь к файлу Explore в параметре include.
Исследование аварий, которое определено в файле модели. Поскольку он определен в самом файле модели, вам не нужно использовать для него параметр include в модели. Однако для представления, на котором основано исследование происшествий, требуется включение.

Включение тестов данных в модель

Проверки данных можно определить непосредственно в файле модели или файле представления. Однако вы также можете создать отдельный файл тестов данных, если хотите повторно использовать тесты данных в нескольких местах вашего проекта.

Если у вас есть отдельный файл проверки данных, вам необходимо использовать параметр включения в файле модели или файле представления, чтобы вы могли запускать проверки данных. В параметре include используйте расширение .lkml для тестовых файлов данных.

Например, ниже приведен отрывок из файла модели, который включает тестовый файл данных:

соединение: "faa" включает: "/explores/aircraft_new.explore.lkml" включает: "/views/accidents.view" включает: "/tests/data_tests.lkml" …

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

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

В большинстве случаев вам не нужно использовать включение в файл представления. Однако в некоторых случаях вы хотите включить файлы в файл представления:

Включение представлений в представление (для расширения или уточнения)

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

Например, вот файл представления marketing_order_fields, который включает файл представления basic_order_fields, а затем расширяет его:

Включение исследований в представление

Файлы исследования будут прослушивать соединение модели, в которую они включены. Учтите этот факт, когда вы включаете файлы исследования в модели, для которых настроено соединение, отличное от родительской модели файла исследования. Если схема подключения включающей модели отличается от схемы подключения родительской модели, это может привести к ошибкам запроса.

В большинстве случаев вам не нужно включать обзор в представление. Однако собственные производные таблицы представляют собой особый случай, поскольку они определены в собственном файле представления с параметром explore_source.Вы используете параметр explore_source, чтобы указать исследование и определить нужные столбцы и другие желаемые характеристики для собственной производной таблицы. Исследования обычно определяются в файле модели, но в случае собственных производных таблиц может быть проще создать отдельный файл для исследования с расширением .explore.lkml. Если вы создаете отдельный файл исследования, вы должны включить его в собственный производный файл табличного представления.

Вот пример использования include в собственном производном файле табличного представления, чтобы указать на файл Explore:

Дополнительную информацию о файлах Explore для собственных производных таблиц см. в нашей документации по использованию операторов include для включения ссылок на поля.

Включение тестов данных в представление

Например, ниже приведена выдержка из файла представления, включающего тестовый файл данных:

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

Вы также можете включить файл теста данных в файл модели, как описано в разделе Включение тестов данных в модель на этой странице.

Если у вас есть отдельный файл исследования, вы можете использовать параметр include для включения представлений или других исследований.

Включение представлений в обзор

Если у вас есть отдельный файл исследования, вам необходимо включить в него все представления, которые используются исследованием. Используйте расширение файла .view для просмотра файлов. Вы можете опустить часть расширения файла .lkml. Вот пример файла Explore, который включает в себя два используемых представления:

Включение исследований в исследование

Файлы исследования будут прослушивать соединение модели, в которую они включены. Учтите этот факт, когда вы включаете файлы исследования в модели, для которых настроено соединение, отличное от родительской модели файла исследования. Если схема подключения включающей модели отличается от схемы подключения родительской модели, это может привести к ошибкам запроса.

Вы можете включить один файл исследования в другой файл исследования, например, когда вы расширяете или уточняете исследование. Используйте параметр include и добавьте расширение файла .explore.lkml .

См. в предыдущих разделах примеры использования включения в файлы модели, файлов просмотра и файлов исследования.

Использование подстановочных знаков

Для проектов, в которых необходимо управлять лишь несколькими файлами, вы можете перечислить каждый файл в отдельном параметре включения, например так:

Но для проектов с большим количеством файлов для включения вы можете уменьшить количество параметров включения, которые необходимо записать, используя подстановочные знаки для одновременного включения нескольких файлов:

Используйте подстановочные знаки с папками IDE, чтобы включить файлы в определенный каталог вашего проекта.
Используйте подстановочные знаки с расширениями файлов, чтобы включить файлы определенного типа.
Используйте подстановочные знаки со стратегическими именами файлов, чтобы включить файлы с определенными префиксами или суффиксами в их именах.

Использование подстановочных знаков может быть особенно полезно во время разработки, когда вам нужно создать временное исправление для предупреждений проверки LookML, особенно при организации существующего проекта в папки IDE. Но при использовании подстановочных знаков в операторах include учитывайте следующее:

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

Использование подстановочных знаков с папками IDE

Вы можете использовать подстановочные знаки в сочетании с папками IDE для включения файлов в определенный каталог в ваш проект LookML.

Например, этот оператор include ссылается на все файлы в каталоге /explores/ проекта LookML:

Использование подстановочных знаков для определенных типов файлов

Вы можете использовать подстановочные знаки для ссылки на все файлы определенного типа. Например, этот оператор include ссылается на все файлы Explore в проекте LookML:

См. раздел «Типы файлов проектов» на странице документации по файлам проектов LookML, где приведен список типов файлов LookML и их расширений.

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

Использование подстановочных знаков со стратегическими шаблонами именования

Вы также можете использовать подстановочные знаки со стратегическими именами файлов, чтобы еще больше оптимизировать операторы включения. Например, вместо того, чтобы называть файлы следующим образом:

К именам файлов можно добавить стратегический префикс или суффикс, например:

/views/apple.fruit.view /views/banana.fruit.view /views/cherry.fruit.view /views/orange.fruit.view /views/celery.vegetable.view

Затем используйте подстановочные знаки для ссылки только на суффикс .fruit, используя это include:

Включение всех файлов представлений может повлиять на производительность проверки LookML

Если в вашем проекте большое количество файлов представлений, и вы включаете их все в файл модели, это может повлиять на производительность LookML Validator. Так как LookML Validator проверяет все файлы представлений, включенные в модель, вы должны включать только необходимые файлы представлений в параметр include файла модели.

Рассмотрите возможность использования соглашений о стратегических именах для файлов представлений, чтобы упростить включение групп представлений в модель (см. пример в разделе Использование подстановочных знаков с шаблонами стратегических имен на этой странице). Или вы можете использовать папки IDE для организации представлений в папки. Затем вы можете использовать подстановочный знак * для включения всех представлений в одну папку вместо включения всех представлений в ваш проект. Дополнительную информацию см. в нашей документации по использованию include с папками IDE.

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

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

Другие ресурсы

help_center Справочный центр

В нашем Справочном центре есть дополнительные короткие статьи о конкретных случаях использования и особых ситуациях.

форум Сообщество

Форумы сообщества Looker — отличное место для обсуждения передового опыта, устранения уникальных проблем и общения с другими пользователями Looker.

школа Подключиться

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

Примеры основаны на гипотетических данных.
© 2012- Looker Data Sciences, Inc.
Политика конфиденциальности | Условия использования

Читайте также: