Произошла ошибка при загрузке файла данных, который не содержит информации об организации

Обновлено: 21.11.2024

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

  • Авро
  • Значения, разделенные запятыми (CSV)
  • JSON (разделитель новой строки)
  • ОРК
  • Экспорт паркета хранится в облачном хранилище.

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

Попробуйте сами

Если вы новичок в Google Cloud, создайте аккаунт, чтобы оценить, как работает BigQuery в реальных сценариях. Новые клиенты также получают бесплатные кредиты в размере 300 долларов США для запуска, тестирования и развертывания рабочих нагрузок.

Прежде чем начать

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

Необходимые разрешения

Чтобы загрузить данные в BigQuery, вам нужны разрешения IAM для запуска задания загрузки и загрузки данных в таблицы и разделы BigQuery. Если вы загружаете данные из Cloud Storage, вам также необходимы разрешения IAM для доступа к сегменту, содержащему ваши данные.

Разрешения на загрузку данных в BigQuery

Чтобы загрузить данные в новую таблицу или раздел BigQuery или добавить или перезаписать существующую таблицу или раздел, вам потребуются следующие разрешения IAM:

  • bigquery.tables.create
  • bigquery.tables.updateData
  • bigquery.tables.update
  • bigquery.jobs.create

Каждая из следующих предопределенных ролей IAM включает разрешения, необходимые для загрузки данных в таблицу или раздел BigQuery:

Кроме того, если у вас есть разрешение bigquery.datasets.create, вы можете создавать и обновлять таблицы с помощью задания загрузки в создаваемых вами наборах данных.

Дополнительную информацию о ролях и разрешениях IAM в BigQuery см. в разделе Предопределенные роли и разрешения.

Разрешения на загрузку данных из облачного хранилища

Чтобы загрузить данные из сегмента Cloud Storage, вам необходимы следующие разрешения IAM:

  • storage.objects.get
  • storage.objects.list (обязательно, если вы используете подстановочный знак URI)

Предопределенная роль IAM roles/storage.objectViewer включает все разрешения, необходимые для загрузки данных из корзины Cloud Storage.

Загрузка данных из облачного хранилища

BigQuery поддерживает загрузку данных из любого из следующих классов хранилищ Cloud Storage:

  • Стандартный
  • Рядом
  • Холодная линия
  • Архивировать

Чтобы узнать, как загружать данные в BigQuery, перейдите на страницу вашего формата данных:

Чтобы узнать, как настроить периодическую загрузку из Cloud Storage в BigQuery, см. раздел Переносы Cloud Storage.

Соображения о местоположении

Выбирая место для своих данных, учитывайте следующее:

  • Расположите сегменты Cloud Storage вместе для загрузки данных.
    • Если ваш набор данных BigQuery находится в нескольких регионах, корзина Cloud Storage, содержащая загружаемые данные, должна находиться в региональной или мультирегиональной корзине в том же месте. Например, если ваш набор данных BigQuery находится в ЕС, сегмент Cloud Storage должен находиться в региональном или мультирегиональном сегменте в ЕС.
    • Если ваш набор данных находится в регионе, ваша корзина Cloud Storage должна быть региональной корзиной в том же месте. Например, если ваш набор данных находится в регионе Токио, ваша корзина Cloud Storage должна быть региональной корзиной в Токио.
    • Исключение: если ваш набор данных находится в нескольких регионах США, вы можете загрузить данные из корзины Cloud Storage в любом регионе или в нескольких регионах.
    • Если вы выбираете ресурс регионального хранилища, например набор данных BigQuery или сегмент Cloud Storage, разработайте план географического управления данными.

    Дополнительную информацию о расположении Cloud Storage см. в разделе Расположение сегментов в документации Cloud Storage.

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

    Получение URI облачного хранилища

    Чтобы загрузить данные из источника данных Cloud Storage, необходимо указать URI Cloud Storage.

    URI Cloud Storage состоит из имени вашей корзины и вашего объекта (имени файла). Например, если сегмент Cloud Storage называется mybucket, а файл данных — myfile.csv, URI сегмента будет gs://mybucket/myfile.csv. Если ваши данные разделены на несколько файлов, вы можете использовать подстановочный знак в URI. Дополнительные сведения см. в разделе URI запроса облачного хранилища.

    BigQuery не поддерживает исходные URI, содержащие несколько последовательных косых черт после начальной двойной косой черты. Имена объектов Cloud Storage могут содержать несколько последовательных символов косой черты ("/").Однако BigQuery преобразует несколько последовательных косых черт в одну косую черту. Например, следующий исходный URI, допустимый в Cloud Storage, не работает в BigQuery: gs:// Bucket /my//object//name .

    Чтобы получить URI облачного хранилища:

    Откройте консоль Cloud Storage.

    Перейдите к расположению объекта (файла), содержащего исходные данные.

    В верхней части консоли Cloud Storage запишите путь к объекту. Чтобы составить URI, замените gs://bucket/file на соответствующий путь, например, gs://mybucket/myfile.json. Bucket — это имя сегмента Cloud Storage, а file — имя объекта (файла), содержащего данные.

    Поддержка подстановочных знаков для URI Cloud Storage

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

    Чтобы добавить подстановочный знак к URI Cloud Storage, добавьте звездочку ( * ) к базовому имени.

    Следующий URI с подстановочным знаком выбирает все файлы в папке с именем fed-samples и любых подпапках fed-samples :

    Следующий URI с подстановочным знаком выбирает только файлы с расширением .csv в папке с именем fed-samples и любых подпапках fed-samples :

    Следующий URI с подстановочным знаком выбирает файлы с шаблоном именования fed-sample*.csv в папке с именем fed-samples . В этом примере не выбираются файлы во вложенных папках fed-samples .

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

    Вы можете использовать только один подстановочный знак для объектов (имен файлов) в корзине. Подстановочный знак может появляться внутри имени объекта или в конце имени объекта. Добавление подстановочного знака к имени корзины не поддерживается. Несколько подстановочных знаков не поддерживаются в исходном URI. Например, путь gs://mybucket/fed-*/temp/*.csv недействителен.

    Для экспорта Google Datastore можно указать только один URI, и он должен заканчиваться на .backup_info или .export_metadata .

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

    • Создавайте внешние таблицы, связанные с экспортом Datastore или Firestore.
    • Загрузить данные экспорта хранилища данных или Firestore из облачного хранилища.

    Ограничения

    При загрузке данных в BigQuery из корзины Cloud Storage действуют следующие ограничения:

    • Если для местоположения вашего набора данных задано значение, отличное от США , региональное или многорегиональное сегментное хранилище Cloud Storage должно находиться в том же регионе, что и набор данных.
    • BigQuery не гарантирует согласованность данных для внешних источников данных. Изменения базовых данных во время выполнения запроса могут привести к неожиданному поведению.
    • BigQuery не поддерживает управление версиями объектов Cloud Storage. Если вы включите номер поколения в URI Cloud Storage, задание загрузки завершится ошибкой.

    В зависимости от формата исходных данных вашего облачного хранилища могут существовать дополнительные ограничения. Для получения дополнительной информации см.:

    Загрузка данных из локальных файлов

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

    • Облачная консоль Google
    • Команда bq load инструмента командной строки bq
    • API
    • Клиентские библиотеки

    При загрузке данных с помощью Cloud Console или инструмента командной строки bq автоматически создается задание загрузки.

    Чтобы загрузить данные из локального источника данных:

    Консоль

    Откройте страницу BigQuery в Cloud Console.

    На панели навигации в разделе "Ресурсы" разверните проект Google Cloud и выберите набор данных.

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

    На странице "Создать таблицу" в разделе "Источник":

    Для Создать таблицу из выберите Загрузить.

    Под надписью "Выбрать файл" нажмите "Обзор".

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

    В качестве формата файла выберите CSV, JSON (разделитель новой строки), Avro, Parquet или ORC.

    На странице "Создать таблицу" в разделе "Назначение":

    В качестве имени набора данных выберите соответствующий набор данных.

    В поле Имя таблицы введите имя таблицы, которую вы создаете в BigQuery.

    Убедитесь, что для параметра "Тип таблицы" установлено значение "Собственная таблица".

    В разделе "Схема" введите определение схемы.

    Для файлов CSV и JSON можно установить флажок Автоматическое определение, чтобы включить автоматическое определение схемы. Информация о схеме самоописывается в исходных данных для других поддерживаемых типов файлов.

    Вы также можете ввести информацию о схеме вручную:

    Нажав "Изменить как текст" и введя схему таблицы в виде массива JSON:

    Использование "Добавить поле" для ручного ввода схемы.

    Выберите соответствующие элементы в разделе «Дополнительные параметры». Информацию о доступных параметрах см. в разделе Параметры CSV и параметры JSON.

    Необязательно: в дополнительных параметрах выберите способ записи:

    • Записать, если пусто. Записывайте данные, только если таблица пуста.
    • Добавить в таблицу: добавление данных в конец таблицы. Этот параметр используется по умолчанию.
    • Перезаписать таблицу. Удалите все существующие данные в таблице перед записью новых данных.

    Нажмите "Создать таблицу".

    Используйте команду загрузки bq, укажите source_format и укажите путь к локальному файлу.

    (Необязательно) Укажите флаг --location и установите значение вашего местоположения.

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

    Замените следующее:

    • МЕСТО: ваше местоположение. Флаг --location необязателен. Например, если вы используете BigQuery в регионе Токио, установите значение флага asia-northeast1 . Вы можете установить значение по умолчанию для расположения с помощью файла .bigqueryrc.
    • ФОРМАТ: CSV, AVRO, PARQUET, ORC или NEWLINE_DELIMITED_JSON.
    • project_id : идентификатор вашего проекта.
    • набор данных: существующий набор данных.
    • table : имя таблицы, в которую вы загружаете данные.
    • path_to_source : путь к локальному файлу.
    • схема : допустимая схема. Схема может быть локальным файлом JSON или может быть введена как часть команды. Вы также можете использовать флаг --autodetect вместо определения схемы.

    Кроме того, вы можете добавить флаги для параметров, которые позволят вам контролировать, как BigQuery анализирует ваши данные. Например, вы можете использовать флаг --skip_leading_rows, чтобы игнорировать строки заголовков в CSV-файле. Дополнительные сведения см. в разделах Параметры CSV и Параметры JSON.

    Следующая команда загружает локальный файл JSON с разделителями новой строки ( mydata.json ) в таблицу с именем mytable в mydataset в вашем проекте по умолчанию. Схема определяется в локальном файле схемы с именем myschema.json .

    Следующая команда загружает локальный CSV-файл ( mydata.csv ) в таблицу с именем mytable в mydataset в myotherproject . Схема определяется в формате FIELD:DATA_TYPE , FIELD:DATA_TYPE .

    Примечание. Когда вы указываете схему в командной строке, вы не можете включать тип RECORD ( STRUCT ), вы не можете включать описание поля и не можете указывать режим поля. Все режимы полей по умолчанию равны NULLABLE. Чтобы включить описания полей, режимы и типы RECORD, вместо этого укажите файл схемы JSON.

    Следующая команда загружает локальный файл CSV ( mydata.csv ) в таблицу с именем mytable в mydataset в вашем проекте по умолчанию. Схема определяется с помощью автоматического определения схемы.

    В следующем коде показано, как загрузить локальный CSV-файл в новую таблицу BigQuery. Чтобы загрузить локальный файл другого формата, используйте класс параметров обновления для соответствующего формата из базового класса JobCreationOptions вместо UploadCsvOptions .

    Прежде чем пробовать этот пример, следуйте инструкциям по настройке Go в кратком руководстве по BigQuery с использованием клиентских библиотек. Дополнительные сведения см. в справочной документации по BigQuery Go API.

    В следующем коде показано, как загрузить локальный CSV-файл в новую таблицу BigQuery. Чтобы загрузить локальный файл другого формата, задайте для свойства DataFormat объекта NewReaderSource соответствующий формат.

    Прежде чем приступить к работе с этим примером, следуйте инструкциям по настройке Java в кратком руководстве по использованию клиентских библиотек BigQuery. Дополнительную информацию см. в справочной документации BigQuery Java API.

    В следующем коде показано, как загрузить локальный CSV-файл в новую таблицу BigQuery. Чтобы загрузить локальный файл другого формата, задайте FormatOptions соответствующий формат.

    Node.js

    Прежде чем пробовать этот пример, следуйте инструкциям по настройке Node.js в кратком руководстве по использованию клиентских библиотек BigQuery. Дополнительные сведения см. в справочной документации по BigQuery Node.js API.

    В следующем коде показано, как загрузить локальный CSV-файл в новую таблицу BigQuery. Чтобы загрузить локальный файл другого формата, установите параметр метаданных функции загрузки в соответствующий формат.

    Прежде чем пробовать этот пример, следуйте инструкциям по настройке PHP в кратком руководстве по использованию клиентских библиотек BigQuery. Дополнительные сведения см. в справочной документации BigQuery PHP API.

    В следующем коде показано, как загрузить локальный CSV-файл в новую таблицу BigQuery.Чтобы загрузить локальный файл другого формата, задайте для параметра sourceFormat соответствующий формат.

    Питон

    Прежде чем приступить к работе с этим примером, следуйте инструкциям по настройке Python в кратком руководстве по использованию клиентских библиотек BigQuery. Дополнительные сведения см. в справочной документации BigQuery Python API.

    В следующем коде показано, как загрузить локальный CSV-файл в новую таблицу BigQuery. Чтобы загрузить локальный файл другого формата, задайте для свойства LoadJobConfig.source_format соответствующий формат.

    Прежде чем пробовать этот пример, следуйте инструкциям по настройке Ruby в кратком руководстве по BigQuery с использованием клиентских библиотек. Дополнительные сведения см. в справочной документации по API BigQuery Ruby.

    Ограничения

    На загрузку данных из локального источника данных распространяются следующие ограничения:

    • Подстановочные знаки и списки, разделенные запятыми, не поддерживаются при загрузке файлов из локального источника данных. Файлы должны загружаться по отдельности.
    • При использовании Cloud Console размер файлов, загружаемых из локального источника данных, не может превышать 10 МБ. Для больших файлов загрузите файл из облачного хранилища.

    Загрузка сжатых и несжатых данных

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

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

    Двоичный формат ORC предлагает преимущества, аналогичные преимуществам формата Parquet. Данные в файлах ORC загружаются быстро, поскольку полосы данных могут считываться параллельно. Строки в каждой полосе данных загружаются последовательно. Чтобы оптимизировать время загрузки, используйте размер полосы данных приблизительно 256 МБ или меньше. Сжатые файлы ORC не поддерживаются, но нижний колонтитул и полосы сжатых файлов поддерживаются. См. сжатие ORC.

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

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

    Добавление или перезапись таблицы

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

    Если вы обновите схему при добавлении данных, BigQuery позволит вам:

    • Добавить новые поля
    • Обновить НЕОБХОДИМЫЕ поля до NULLABLE

    Если вы перезаписываете таблицу, схема всегда перезаписывается. Обновления схемы не ограничены при перезаписи таблицы.

    В Cloud Console используйте параметр настройки записи, чтобы указать, какое действие следует выполнять при загрузке данных из исходного файла или из результата запроса. Инструмент командной строки bq и API включают следующие параметры:

    Параметры консоли флаг инструмента bq свойство API BigQuery описание
    Записать, если пусто Нет WRITE_EMPTY Записывает данные, только если таблица пуста.
    Добавить в таблицу --noreplace или --replace=false ; если --replace не указан, по умолчанию используется append WRITE_APPEND (по умолчанию) Добавляет данные в конец таблицы.
    Перезаписать таблицу --replace или --replace=true WRITE_TRUNCATE Удаляет все существующие данные в таблице перед записью новых данных.< /td>

    Политика квот

    Информацию о политике квот для пакетной загрузки данных см. в разделе Загрузка заданий на странице Квоты и ограничения.

    Цены

    За пакетную загрузку данных в BigQuery плата не взимается. Дополнительную информацию см. в разделе Цены на прием данных BigQuery.

    Если не указано иное, содержимое этой страницы предоставляется по лицензии Creative Commons Attribution 4.0, а образцы кода — по лицензии Apache 2.0. Подробнее см. в Правилах сайта Google Developers. Java является зарегистрированным товарным знаком Oracle и/или ее дочерних компаний.

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

    Примечание. Если вы хотите выполнить массовый импорт как организаций, так и пользователей, сначала необходимо выполнить массовый импорт организаций. Информацию о массовом импорте пользователей см. в разделе Массовый импорт пользователей.

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

    Ограничения массового импорта пользователей и организаций

    Вы можете импортировать основной набор данных о пользователях и организациях. Например, используя массовый импорт, вы можете импортировать данные, описанные в таблице ниже; однако вы не можете импортировать часовые пояса, фотографии, языковые настройки и т. д. Чтобы импортировать данные, не перечисленные в таблице ниже, вам нужно вместо этого использовать Zendesk REST API. См. раздел Импорт пользователей с помощью Zendesk API или Импорт организаций с помощью Zendesk API.

    • Файл импортируемых данных CSV должен содержать не более 2000 строк данных (одна строка для заголовка, а остальные — для данных пользователя или организации).
    • За один раз можно импортировать только один CSV-файл, содержащий не более 2000 строк данных. Поэтому, если у вас есть более 1999 пользователей или организаций для импорта, вам необходимо создать отдельные файлы для каждого пакета и импортировать их один за другим. До двух пакетов помещаются в очередь и выполняются в фоновом режиме. Если вы хотите импортировать более двух пакетов, вам нужно дождаться завершения импорта первых пакетов, чтобы добавить больше.
    • Вы не можете использовать массовый импорт для импорта контактной информации из аккаунтов конечных пользователей Facebook или Twitter. Вместо этого используйте Zendesk REST API. См. раздел Импорт пользователей с помощью Zendesk API.

    Создание файла данных организации в формате CSV

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

    • Файл должен быть правильно отформатирован в формате CSV и сохранен с использованием кодировки символов UTF-8.
    • Первая строка CSV-файла — это строка заголовка, и вы должны включить ее в файл.
    • Строка заголовка должна содержать все обязательные поля из приведенной ниже таблицы, а также любые другие поля, перечисленные в приведенной ниже таблице, которые вы хотите включить.
    • Включенные поля должны отображаться в строке заголовка в том порядке, в котором они перечислены ниже.
    • Если вы не импортируете данные для поля, не указывайте его в строке заголовка.
    • Пустые столбцы данных в файле перезапишут любые существующие данные для этого пользователя.
    • Добавьте разрывы строк в заметки или многострочные настраиваемые поля, нажав ALT+ВВОД в Windows или CTRL+OPTION+RETURN на Mac.
    Таблица 1. Данные импорта организации
    Поле Описание
    имя Обязательно. Название организации.
    external_id Если у вас есть уникальный идентификатор, отличный от названия организации, вы можете указать его здесь.
    примечания Примечания об организации. Примечания видны только агентам, но не конечным пользователям.
    подробности Подробная информация об организации, например адрес. Эта информация видна только агентам, но не конечным пользователям.
    по умолчанию Это для сопоставления пользователей с организацией. Введите один или несколько доменов электронной почты, разделенных пробелами.

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

    Примечание. Чтобы найти ключ для настраиваемого поля организации, щелкните значок администратора ( ) и выберите «Поля организации», затем щелкните имя настраиваемого поля. Ключ поля появится на панели свойств справа.

    Если значение поля имеет неправильный формат, импорт завершится ошибкой, и вы получите отчет об ошибке, в котором будет указано, какие записи не удалось сохранить. Для настраиваемых полей даты используйте формат ГГ/ММ/ДД или ГГГГ-ММ-ДД.

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

    Импорт файла данных организации в формате CSV

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

    1. В Центре администрирования нажмите значок "Люди" ( ) на боковой панели, затем выберите Массовые действия > Импортировать организации.
    2. Выберите нужный тип импорта:

    Создавать новые организации

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

    Ваш импорт добавляется в очередь, а организации добавляются в Zendesk Support после завершения процесса импорта. Это должно занять около часа на файл, но это зависит от размера файла и размера очереди. См. Ограничения массового импорта пользователей и организаций. Когда импорт будет завершен, вы получите электронное письмо.

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

    Вы также можете обновить несколько существующих аккаунтов из электронной таблицы.

    Прежде чем начать

    • Убедитесь, что это правильный вариант: загрузите пользователей с электронной таблицей, если вы добавляете до 150 000 пользователей. Однако если у вас есть сервер LDAP, например Microsoft Active Directory, или вы обладаете навыками программирования, мы рекомендуем другие варианты для крупных организаций. Подробнее см. в разделе «Параметры добавления пользователей».

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

    Добавить пользователей из электронной таблицы

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

    Совет. Если вы забыли пароль нового пользователя, сбросьте пароль, а затем отправьте новый пароль пользователю по электронной почте.

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

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

    Описания столбцов и сведения о форматировании см. в приведенных ниже рекомендациях.

    Ваша таблица должна выглядеть примерно так:

    Заполнив таблицу, сохраните ее как файл CSV (.csv).

    Примечания:

    • Максимальный размер CSV-файла – 35 МБ.
    • Максимальное количество записей в файле – 150 000.

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

    1. В верхней части страницы "Пользователи" нажмите Массовое обновление пользователей.
    2. Нажмите "Прикрепить CSV-файл".
    3. Перейдите в папку на своем компьютере и прикрепите CSV-файл.
    4. Нажмите «Загрузить». Если произошла ошибка, введите недостающую информацию в таблицу и снова загрузите файл. Дополнительную информацию см. в разделе Устранение распространенных ошибок ниже.

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

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

    Чтобы новые пользователи получили доступ к службам Google и появились в Каталоге, может пройти до 24 часов. Узнайте больше о Каталоге.

    Следуйте рекомендациям по формату электронных таблиц

    Заключите значения в двойные кавычки, например, "123 Anystreet, Anytown"

    Обязательные столбцы

    Если вы обновляете данные существующих пользователей и не хотите менять их пароли, введите **** (4 звездочки).

    Если также указана хэш-функция пароля, столбец пароля должен содержать хешированный пароль.Например, если вы используете SHA-1, а хэш пароля abc — xyz, введите xyz в столбце «Пароль».

    Для размещения пользователей в организационном подразделении.

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

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

    / (для родителя верхнего уровня — не вводите имя своего домена)

    /Продажи (для дочернего элемента ниже родителя верхнего уровня)

    /Студенты/Первоклассники

    Необязательные столбцы

    Столбец «Пароль» должен содержать хешированный пароль. Например, если вы используете SHA-1, а хэш пароля abc — xyz, введите xyz в столбце «Пароль».

    Совет. В Интернете можно найти утилиты для создания хешированных паролей с использованием поддерживаемых хеш-функций.

    За предоставление информации для восстановления, используемой для проблем со входом в систему.

      Резервный адрес электронной почты — адрес электронной почты за пределами вашего домена.

    Резервный номер телефона – должен быть в формате E.164. Они должны начинаться со знака плюс (+), за которым следует код страны, код города и номер телефона. Записи могут содержать не более 15 цифр. Пример: +16505551212.

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

    Только для редактирования существующих учетных записей пользователей. Чтобы назначить пользователю другую лицензию, введите идентификатор SKU для лицензии. Разделяйте несколько идентификаторов лицензий запятыми, например: 1010020020, Google-Drive-storage-20GB, 1010330002

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

    Устранение распространенных ошибок

    Ошибка Причина/решение
    Файл пуст Ваш файл не содержит никакой информации.
    Неверный формат файла или неизвестное имя столбца Столбцы в вашем файле должны называться Имя [Обязательно], Фамилия Имя [Требуется], Адрес электронной почты [Требуется], Пароль [Требуется] и Путь организационного подразделения [Требуется].
    Файл должен иметь "имя столбца" столбец Отсутствует обязательный столбец.
    Пустой "имя ​​столбца" в строке nn< /em> Столбец, требующий информации, пуст в определенной строке.

    Например, вы увидите сообщение об ошибке Пусто "Путь к организационному подразделению [Обязательно]" в строке 2, если вы не ввели организационное подразделение, в которое хотите поместить учетную запись пользователя. Перейдите к пути организационного подразделения выше.

    Эта ошибка обычно означает одну из следующих ошибок форматирования:

    • Столбец "Путь организационного подразделения" имеет неправильный формат.
    • Одно или несколько введенных вами организационных подразделений не существуют в консоли администратора. Убедитесь, что названия организационных подразделений совпадают с названиями в вашей организационной иерархии в консоли администратора.

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

    Обновите существующие учетные записи пользователей

    Если вам нужно изменить несколько аккаунтов, вы можете сэкономить время, загрузив список аккаунтов из консоли администратора.

    Прежде чем начать

    • Любая информация в столбцах, которые вы можете редактировать, заменяет существующую информацию в консоли администратора при загрузке файла.
    • Столбцы, которые вы не хотите изменять, можно либо удалить (если столбец не требуется), либо оставить их информацию в файле, либо удалить их информацию.
    • Если вы удалите всю ненужную информацию из столбца, но оставите этот столбец в электронной таблице, существующая информация не будет удалена из учетной записи пользователя при загрузке файла.
    • Если вы не хотите менять пароль пользователя, убедитесь, что столбец "Пароль" содержит символы **** (4 звездочки).
    • Если вы не хотите изменять информацию о конкретном пользователе, вы можете оставить его строку в электронной таблице или удалить ее. Если вы удалите всю информацию о пользователе из файла, его учетная запись не будет удалена.
    • Чтобы изменить имя пользователя, введите новый адрес электронной почты в столбце "Новый основной адрес электронной почты".
    • Если вы изменили основной домен для своего аккаунта Google Workspace, подробные инструкции см. в разделе Массовое переименование адресов пользователей после изменения основного домена.

    Редактировать несколько учетных записей пользователей

    Ваш список задач откроется автоматически и покажет ход загрузки.

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

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

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

    Если у вас есть сервер LDAP, например Microsoft Active Directory, вы можете использовать Google Cloud Directory Sync для синхронизации ваших пользователей, групп и общих контактов Google в соответствии с информацией на вашем сервере LDAP.

    Хотите, чтобы кто-нибудь сделал это за вас? Получите профессиональную помощь по настройке.

    Статьи по теме


    Google, Google Workspace и связанные с ними знаки и логотипы являются товарными знаками Google LLC. Все остальные названия компаний и продуктов являются товарными знаками компаний, с которыми они связаны.

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