Как работать с API Google Таблиц (Google Sheets API v4) на языке R с помощью нового пакета googlesheets4 / Хабр
Электронные таблицы по-прежнему остаются довольно популярным инструментом для работы с данными, а среди различных процессоров электронных таблиц наиболее популярными являются Google Таблицы. Во-первых, это бесплатный инструмент, во-вторых, функционал Google Таблиц достаточно широк, и они предоставляют вам возможность в онлайн режиме получить доступ к данным.
В этой статье мы разберёмся с тем, как на языке программирования R работать с Google Sheets API v4 с помощью пакета googlesheets4
, а точнее:
- Как пройти авторизацию для работы с Google Таблицами по API;
- Рассмотрим основные функции пакета;
- Разберём примеры кода для чтения данных, создания новых таблиц и выполнения других манипуляций с Google Таблицами по API.
Также эта статья поможет пользователям устаревшего пакета googlesheets
мигрировать на новый googlesheets4
.
Для тех кому лень читать статью, вот ссылка на 10 минутный, русскоязычный видео урок на YouTube. Остальным добро пожаловать под кат.
Если вы интересуетесь анализом данных, и в частности языком R, возможно вам будут интересны мои telegram и youtube каналы. Большая часть контента которых посвящена языку R.
- Зачем переходить на работу с пакетом googlesheet4
- Миграция с googlesheets на googlesheets4
- Установка пакета googlesheets4
- Авторизация
4.1. Авторизация со стандартными параметрами
4.2. Авторизация через собственное приложение
4.3. Авторизация через сервисный аккаунт
4.4. Разница между авторизацией через приложение и через сервисный аккаунт - Основные функции пакета googlesheets4
- Пример работы с API Google Таблиц на языке R
6.1. Загрузка данных из существующих Google Таблиц
6.2. Создание Google Таблиц с помощью API
6. 3. Создание нового листа в Google Таблице
6.4. Дописываем строки в существующий лист
6.5. Перемещение Google Таблиц между папаками Google Диска - Полезные ссылки по теме статьи
- Заключение
Если вы уже являетесь активным пользователем языка R, и на практике вам встречались задачи по работе с Google Sheets API наверняка вы уже знакомы с пакетом
. И вполне резонно, что первый вопрос который возник у вас в голове — «А чем же googlesheets4 лучше?».
На самом деле по функционалу они похожи, возможно даже googlesheets
пока имеет больше возможностей, но он работает только с Google Sheets API V3. Google несколько месяцев назад сообщил, что поддержка 3 версии данного API будет прекращена 3 марта 2020 года.
Именно поэтому, даже если вас вполне устраивает пакет googlesheets
, вам в любом случае до 3 марта необходимо мигрировать на
, надеюсь данная статья вам в этом поможет.
Что бы максимально упростить миграцию с устаревшего пакета googlesheets
на новый googlesheets4
я решил добавить таблицу соответвия новых функций старым.
Для работы с API Google Таблиц, как я уже писал выше, мы будем использовать пакет googlesheets4
, написанный Дженни Брайан из RStudio.
Установить его можно как из CRAN, так и из GitHub.
Устновка из CRAN:
install.packages('googlesheets4')
Установка из GitHub:
# установка пакета devtools if ( !require(devtools) ) install.packages("devtools") # установка пакета googlesheets4 devtools::install_github("tidyverse/googlesheets4") # подключаем пакет library(googlesheets4)
В пакете googlesheets4
есть по меньшей мере 3 способа авторизации:
- Использовать стандартные параметры функции
gs4_auth()
. - Авторизоваться через собственное приложение.
- Авторизоваться через сервисный аккаунт.
Авторизация со стандартными значениями аргументов
Наиболее простой способ авторизации предоставляет функция gs4_auth()
со значением аргументов принятых в ней по умолчанию.
Минус этого подхода заключается в том, что вы будете использовать приложение вшитое в пакет по умолчанию, как и 90% других его пользователей. Каждое приложение имеет квоты на количество отправляемых запросов, поэтому с ростом количества пользователей данного пакета возрастает и шанс выйти за выделенные лимиты.
Поэтому я рекомендую самостоятельно создать приложение в Gogle Cloud, и пройти авторизацию с его помощью.
Авторизация через собственное приложение
Как создать своё приложение?
Для создания приложения следуйте приведённым ниже инструкциям:
- Переходим в Google Cloud Console и создаём там проект, если у вас ещё нет созданного. Также для создания проекта можно воспользоваться ссылкой.
- Переходим в «Основное меню» > «API и сервисы» > «Учетные данные».
- «Создать учетные данные» > «Идентификатор клиента OAuth».
- Вводим любое произвольное название для вашего приложения.
- Далее будет сгенерирован id и secret вашего приложения.
- Теперь вам необходимо либо скачать JSON файл с созданными учётными данными, либо скопировать id и секрет созданного вами приложения.
Скачиваем JSON
Копируем ID и секрет приложения
Если вы впервые создаёте приложение в Google Console, то также вам предварительно понадобиться создать «Окно запроса доступа OAuth», просто заполните в нём название и ваш email, насколько я помню больше там никаких обязательных полей нет.
Последний шаг, включаем Google Sheets API, для этого достаточно перейти по этой ссылке и нажать кнопку включить API.
Теперь возвращаемся в RStudio, подключаем пакет и проходим авторизацию через своё приложение.
Проходим авторизацию через JSON файл:
# подключаем пакет
library(googlesheets4)
# указываем путь к JSON файлу, который ранее скачали
gs4_auth_configure(path = "C:/path/to/app_credential. json")
# проходим авторизацию
gs4_auth(email = "[email protected]")
Проходим авторизацию указав в коде ID и Секрет приложения:
# подключаем пакет
library(googlesheets4)
# указываем путь к JSON файлу, который ранее скачали
httr::oauth_app(appname = "app_name",
key = "00000000-abcdefghk.apps.googleusercontent.com",
secret = "qwertyuiopasdf")
# проходим авторизацию
gs4_auth(email = "[email protected]")
После запуска функции gs4_auth()
, в приведённых выше примерах кода, вы будете перенаправлены в браузер. Там вы подтверждаете разрешение на доступ к данным и возвращаетесь в RStudio для продолжения работы.
Авторизация через сервисный аккаунт
Для начала надо создать сервисный аккаунт, вот алгоритм действий который вам необходимо выполнить:
- Создать проект в Google Cloud, если он ещё не создан.
- Включить Google Sheets API, для этого необходимо перейти по этой ссылке.
- Для создания сервисного аккаунта перейдите по этой ссылке.
- Заполните его название и описание (при необходимости) и нажмите «Создать».
- Роль устанавливать не надо, поэтому жмём «Продолжить».
- В следующем окне жмём «Создать ключ» > Тип ключа выбираем JSON > Создать.
- Запоминаем расположение и название JSON файла, при сохранении вы можете дать ему любое название.
- Жмём «Готово».
Теперь у вас появился сервисный аккаунт, откройте его и скопируйте почту.
При авторизации под сервисным аккаунтам вы можете работать только с теми Google Таблицами к которым вы предоставили доступ для созданного сервисного аккаунта по его почте. Доступ предоставляется также, как и обычному пользователю.
- Открываем Google Таблицу.
- Жмём «Настройка доступа».
- Открываем доступ на почту созданного сервисного аккаунта.
Проходим авторизацию через сервисный аккаунт:
# подключаем пакет
library(googlesheets4)
# проходим авторизацию через сервисный аккаунт
gs4_auth(path = "C:/path/to/service_credential. json")
При авторизации через сервисный аккаунт вам не понадобится подтверждать доступ к данным через браузер, но ещё раз напомню, что вам надо отдельно расшаривать доступ сервисному аккаунту к каждой Google Таблице, с которой вам необходимо работать по API.
Разница между авторизацией через приложение и через сервисный аккаунт
Основными отличиями между авторизацией через приложение и через серверный аккаунт являются:
- При авторизации через сервисный аккаунт не требуется подтверждать доступ к данным через браузер.
- Сервисный аккаунт имеет доступ только к тем Google таблицам к которым вы сами ему предоставили доступ на почту. При авторизации через приложение вы подтверждаете доступ ко всей доступной вашему Google аккаунту информации.
По этим двум причинам наиболее предпочтительным способом автризации является авторизация через сервисный аккаунт. Но важно понимать, что если кто-то посторонний получит доступ к JSON файлу с ключём от сервисного аккаунта, он автоматически завладеет всеми правами и доступами которые вы предоставили этому сервисному аккаунту.
Все функции пакета googlesheets4
разделены на 3 группы, каждая группа функций имеет свой префикс, который говорит об области действия этой функции:
gs4_
— объединяет функции реализующие операции над книгой GoogleSheetssheet_
— операции над рабочими листамиrange_
— операции над отдельными диапазонами ячеекcell_
— операции над отдельными ячейками
Давайте рассмотрим основные функции пакета googlesheets4.
gs4_auth()
— Авторизация;gs4_create()
— Создаёт новую Google Таблицу;gs4_browse()
— Открывает Google Таблицу в браузере;as_sheets_id()
— Инициализирует подключение к Google Таблице, в качестве единственного аргумента принимает URL или ключ нужной Google Таблицы;range_read()
— Считывает данные из указанного листа Google Таблицы;sheet_write()
— Записывает данные в Google Таблицу, при необходимости создаёт новый лист. Если вы пытаетесь записать данные на существующий лист то все данные будут перезаписаны;sheet_append()
— Дописывает данные на уже существующий лист;sheet_add()
— Создаёт новые листы в существующей Google Таблице;sheet_delete()
— Удаляет существующие листы из Google Таблицы;sheet_names()
— Выводит вектор содержащий имена листов Google Таблицы.
Пакет содержит также множество вспомогательных функций, но думаю перечисленных выше вам будет более чем достаточно для выполнения любых действий с Google Таблицами.
Теперь я приведу примеры кода для выполнения основных операций с Google Таблицами.
Для примера нам потребуются какие-нибудь тестовые наборы данных. Что бы не изобретать велосипед мы будем использовать созданную мной Google Таблицу и встроенные в R датасеты iris
, mtcars
и ToothGrowth
.
Загрузка данных из существующих Google Таблиц
Считывание данных из Google Таблицы является наиболее часто используемой операцией.
Алгоритм действий достаточно прост, вам необходимо инициализировать подключение к нужной таблице, и считать данные с существующего в ней листа.
Для подключения вам необходимо воспользоваться функцией as_sheet_id()
, в которую следуют передать ключ или URL адрес Google Таблицы.
URL: https://docs.google.com/spreadsheets/d/1hP1OwJuSHfvrTZvZUgEHDwcPPVlDMwPwCqCQPs64OSE/
Ключ: 1hP1OwJuSHfvrTZvZUgEHDwcPPVlDMwPwCqCQPs64OSE
Как вы поняли из приведённого выше примера ключ это часть URL адреса таблицы, которая находится между /d/
и следующие слешем .
Для чтения данных в googlesheets4
предназначена функция range_read()
.
Пример кода для чтения данных из Google Таблицы
# подключаем пакет
library(googlesheets4)
# проходим авторизацию одним из описанных способов
gs4_auth(email = "[email protected]")
# подключаемся к тестовому доксу
my_dox <- as_sheets_id("1hP1OwJuSHfvrTZvZUgEHDwcPPVlDMwPwCqCQPs64OSE")
# считываем данные с листа test_data
data <- range_read(my_dox, sheet = "test_data")
Процесс подключения и чтения данных можно записать более компактно используя пайплайны.
data <- as_sheets_id("1hP1OwJuSHfvrTZvZUgEHDwcPPVlDMwPwCqCQPs64OSE") %>%
range_read("test_data")
Создание Google Таблиц с помощью API
Для создания новой таблицы используйте функцию gs4_create()
и следующие её аргументы.
- name — Имя Google Таблицы;
- locale — Региональные настройки;
- timeZone — Часовой пояс;
- sheets — Принимает вектор с именами листов, либо список, название каждого элемента списка будет сконвертировано в имя листа, а в качестве значений вы можете передать дата фреймы которые будут записаны на эти листы.
Пример создания Google Таблицы
# подключаем пакет
library(googlesheets4)
# проходим авторизацию одним из описанных способов
gs4_auth(email = "[email protected]")
# создаём Google Таблицу
ss <- gs4_create(name = "my_new_dox",
locale = "ru_RU",
sheets = list(mtcars = mtcars,
iris = head(iris)))
# открываем созданную таблицу в браузере
gs4_browse(ss)
Приведённый выше код создаст новую Google Таблицу «my_new_dox», в которой будут 2 листа: mtcars, iris.
Создание нового листа в Google Таблице
Итак, только что мы создали новую Google Таблицу, и при этом инициировали объект подключения к ней, который назвали ss
.
Теперь мы можем проводить с созданной таблицей различные манипуляции, например создать в ней новый лист.
Пример кода для создания нового листа с данными
# создаём новый лист с данными
sheet_write(ToothGrowth, ss,
sheet = "tooth_growth")
Writing to 'my_new_dox'
Writing to sheet "tooth_growth"
Функция sheet_write()
имеет 3 основных аргумента:
- data — Дата фрейм с данными которые вы хотите записать на новый лист, или перезаписать данные на существующем листе.
- ss — Объект подключения к Google Таблице, который вы можете получить с помощью функций
as_sheets_id()
илиgs4_create()
. - sheet — Название листа который будет создан в Google Таблице, или на котором будут перезаписаны данные.
Дописывание строк в существующий лист
Ещё одна достаточно важная операция — добавление данных на уже существующий лист.
Осуществляется эта операция функцией sheet_append()
, которая имеет 3, уже знакомых вам аргумента.
- data — Дата фрейм с данными которые вы хотите дописать на существующий лист.
- ss — Объект подключения к Google Таблице, который вы можете получить с помощью функций
as_sheets_id()
илиgs4_create()
. - sheet — Название листа на который требуется дописать строки.
При создании таблицы my_new_dox мы записали на лист iris только первые 6 строк с данными, давайте допишем оставшиеся.
Пример кода для добавления строк на существующий лист
# дописываем строки на лист iris
sheet_append(data = iris[7:150,], ss,
sheet = "iris")
Writing to 'my_new_dox'
Appending 144 row(s) to 'iris'
Перемещение Google Таблиц между папаками Google Диска
Ещё одна операция которая может вам пригодиться, но в данном случае помимо googlesheets4
вам понадобится пакет googledrive
.
Установка googledrive
install.packages("googledrive")
Переместить созданную ранее Google Таблицу можно с помощью функции drive_mv()
. Но предварительно необходимо пройти автооризацию с помощью функции drive_auth()
.
Авторизация в пакете googledrive
ничем не отличается от описанной в начале этой статьи, т.к. оба рассматриваемых пакета для авторизации используют вспомогательный пакет gargle
. Авторизовавшись с попощью функции drive_auth()
вы можете передать полученный токен в пакет googlesheets4
для совместного использования: gs4_auth(token = drive_token())
.
Далее открываем на Google Диске нужную папку и копируем её URL или ключ. Если нужная папка ещё не создана её можно создать с помощью функции drive_mkdir()
.
Для инициализации подключения к папке используем функцию as_id()
.
Пример кода для перемещения Google Таблицы из одной папки Google Диска в другую
# Подключаем библиотеки
library(googlesheets4)
library(googledrive)
# авторизация
## можно либо дважды пройти авторизацию, отдельно под каждым пакетом
## gs4_auth(email = "your_email@gmail. com")
## drive_auth(email = "[email protected]")
## либо пройти авторизацию с помощью google drive, и передать полученный токен для дальнейшего использования в google sheets
drive_auth(email = "[email protected]")
gs4_auth(token = drive_token())
# Инициируем подключение к таблице и папке
## Подключаемся к таблице которую требуется переместить
ss <- as_sheets_id("1BNrYUajVSR3wuGySY0ybXrqh4-Jjq-eIS5_f_a6kt_c")
## Подключаемся к папке в которую надо перенести Google таблицу
folder <- as_id("1x94xChfZwSCPFzHvWqwk6HyF85_ASDFW")
# Либо создаём новую папку
## folder <- drive_mkdir("my_folder")
# Переносим Google Таблицу в нужную директорию
drive_mv(file = ss,
path = folder)
File moved:
* my_new_dox -> my_folder/my_new_dox
В этом разделе приведу несколько полезных ссылок по теме статьи:
Описанных в статье возможностей пакета googlesheets4
достаточно для решения подавляющего большинства задач, в которых необходимо использовать Google Sheets API.
На данный момент googlesheets4
находится в стадии активной разработки. Автор пакета планирует реализовать его функционал в полном объёме к марту 2020 года, в связи с чем в статье возможны корректировки и дополнения по мере изменения или расширения возможностей пакета.
Если вы дочитали до этого параграфа, то наверняка интересуетесь, и скорее всего уже используете язык R в работе. Если это так, то думаю вам будет интересен мой телеграм и youtube каналы, большая часть контента которых посвящена языку R.
Классификация МАСЕЛ по API
API система классификации моторных масел (API Engine Service Classification System) развивалась с 1969 года в результате совместной работы API, ASTM и SAE. Система полностью изложена в стандартах ASTM D 4485«Стандартная спецификация на качество эксплуатационных свойств моторных масел» (Standart Performance Specification for Performance of Engine Oils) и SAE J183 APR96 «Качество эксплуатационных свойств моторных масел и эксплуатационные классификации двигателей (за исключением энергосберегающих масел)»(Engine Oil Performance and Engine Service Classifications (Other than «Energy Conserving»). Новый качественный шаг в развитии качества и классификации моторных масел был сделан в 1983-1992 годах, когда под руководством API и участии представителей производителей автомобилей (ААМА), двигателей (ЕМА) и технических союзов (ASTM иSAE) была создана и развита «Система лицензирования и сертификации моторных масел EOLCS» (Engine Oil Licensing and Certification System, API Publication No. 1509). Эта система постоянно совершенствуется. В настоящее время аттестация моторных масел проводится согласно требованиям EOLCS и «Свода правил СМА» (СМА Code of Practice).
По системе API (ASTM D 4485, SAE J183 APR96) установлены три эксплуатационные категории (три ряда) назначения и качества моторных масел:
S (Service) — состоит из категорий качества моторных масел для бензиновых двигателей, идущих в хронологическом порядке. Для каждой новой генерации присваивается дополнительная буква по алфавиту:
API SA, API SB, API SC, API SD, API SE, API SF, API SG, API SH и API SJ (категория SI — намеренно пропущена API, для исключения путаницы с Международной системой мер).
Категории API SA, API SB, API SC, API SD, API SE, API SF, API SG на сегодняшний день признаны недействительными, как устаревшие, однако в некоторых странах масла этих категорий еще выпускаются, категория API SH является «условно действующей» и может использоваться только как дополнительная, например API CG-4/SH.
Класс SL введен 2001 г. и отличается от SJ существенно лучшими антиокислительными, противоизносными, противопенными свойствами, а также меньшей испаряемостью;
C (Commercial) — состоит из категорий качества и назначения масел для дизельных двигателей, идущих в хронологическом порядке. Для каждой новой генерации присваивается дополнительная буква по алфавиту:
API СA, API СB, API СC, API СD, API СD-II, API CE, API CF, API CF-2, API CF-4, API CG-4 и API CH-4.
Категории API СA, API СB, API СC, API СD, API СD-II на сегодняшний день признаны недействительными, как устаревшие, однако в некоторых странах масла этих категорий еще выпускаются;
EC (Energy Conserving) — энергосберегающие масла — новый ряд высококачественных масел, состоящий из маловязких, легкотекущих масел, уменьшающих расход топлива по результатам тестов на бензиновых двигателях.
Моторные масла, отличающиеся низкой вязкостью как при низкой, так и при высокой температуре могут быть сертифицированы на соответствие категории API EC «энергосберегающее» масло («Energy Conserving» Oil). Ранее энергосбережение определялось по методике Последовательности VI (Sequence VI, ASTM RR D02 1204). Данная методика использовалась для сертификации масел категории API SH на уровни (степени) энергосбережения: API SH/EC — 1,5% экономии топлива и API SH/ECII — 2,7% экономии топлива, по сравнению с эталонным маслом SAE 20w-30. Римские цифры после букв ЕС указывают уровень получаемой экономии топлива (ЕС II — 2,5%).
Влияние систем по контролю эмиссии вредных веществ
Универсальные масла для бензиновых и для дизельных двигателей обозначаются двумя символами соответствующих категорий: первый символ является основным, а второй указывает на возможность применения этого масла для двигателя другого типа. Например, API CG-4/SH — масло, оптимизированное для применения в дизельных двигателях, но его можно применять и в бензиновых двигателях, для которых предписывается масло категории API SH и ниже (SG, SF, SE и т. д.).
Для бензиновых двигателей — классы масел по шкале S | |||
Группа масел | Рекомендуемая область применения | Годы выпуска автомобилей | Качественные показатели |
SN | Введена в октябре 2010г. Это последняя сервисная категория для автомобилей с бензиновыми двигателями. Этот новый североамериканский стандарт заменил предыдущую сервисную категорию SM, которая была введена в 2004 г. Моторные масла, отвечающие API SN, могут использоваться в двигателях, которым предписаны категории API SM и более ранние категории S. Масла API SN улучшены по сравнению с API SM в областях окислительной стабильности и контроля отложений и шламов. API также ввело новое обозначение «Сберегающее Ресурсы» (Resource Conserving), которое может использоваться в связке с API SN. Обозначение «Сберегающее Ресурсы» заменило предыдущее обозначение «Сберегающее Энергию» (Energy Conserving). В то время как обозначение «Сберегающее Энергию» было сфокусировано только на экономии топлива, новое обозначение «Сберегающее Ресурсы» охватывает экономию топлива, защиту системы очистки выхлопных газов и турбонаддувов, а также совместимость с топливами, содержащими этанол (вплоть до Е85, т.е. с топливами, содержащими до 85 % биоэтанола). Другими словами основное отличие API SN от предыдущих классификаций API в ограничении содержания фосфора для совместимости с современными системами нейтрализации выхлопных газов, а также комплексное энергосбережение. То есть, масла, классифицируемые по API SN, приблизительно соответствовуют АСЕА С2, С3, С4, без поправки на высокотемпературную вязкость. | с 2011 | — |
SM | Введена в ноябре 2004. Тенденции развития техники направлены на повышение их экологической безопасности, увеличение интервалов техобслуживания при сохранении надежности работы. Естественно, это вносит свои коррективы в процесс совершенствования двигателей, отображаясь и на качествах смазывающих материалов. Следуя данным тенденциям, в ноябре 2004 года в классификации API появился класс на моторные масла для бензиновых двигателей — SM, предполагающий, по сравнению с SL, повышенные требования к смазывающим материалам относительно стойкости к окислению, защите от отложений, износа и т.д. С октября 2006 года пополнилась категория и для дизельных масел классом CJ-4. | с 2004 | — |
SL | (Действующая). API планировал разрабатывать проект PS-06 как следующую категорию API SK, но один из поставщиков моторных масел в Корее использует сокращение «SK» как часть своего корпоративного имени. Для исключения возможной путаницы буква «К» будет пропущена для следующей категории «S». — стабильность энергосберегающих свойств; — пониженная летучесть; — удлиненные интервалы замены. | c 2001 | — |
SJ | (Действующая). Категория утверждена 06.11.1995, лицензии стали выдаваться с 15.10.1996. Автомобильные масла данной категории предназначены для всех используемых в настоящее время бензиновых двигателей и полностью заменяют масла всех существовавших ранее категорий в более старых моделях двигателей. Максимальных уровень эксплуатационных свойств. Возможность сертификации по категории энергосбережения API SJ/EC. | c 1996 | — |
SH | (Условно действующая). Лицензированная категория, утвержденная в 1992 году. На сегодняшний день категория является условно действующей и может быть сертифицирована только как дополнительная к категориям API C (например API AF-4/SH). По требованиям соответствует категории ILSAC GF-1, но без обязательного энергосбережения. Автомобильные масла данной категории предназначены для бензиновых двигателей моделей 1996 года и старше. При проведении сертификации на энергосбережение, в зависимости от степени экономии топлива присваивались категории API SH/EC и API SH/ECII. | с 1993 | высшее для моделей с 1995 г.в. |
SG | Лицензированная категория, утвержденная в 1988 году. Выдача лицензий прекращена в конце 1995 года. Автомобильные масла предназначены для двигателей моделей 1993 года и старше. Топливо — неэтилированный бензин с оксигенатами. Удовлетворяют требованиям, выдвигаемым к автомобильным маслам для дизельных двигателей категории API CC и API CD. Имеют более высокую термическую и противоокислительную стабильность, улучшенные противоизносные свойства, уменьшенную склонность к образованию отложений и шлама. Автомобильные масла API SG заменяют масла категорий API SF, SE, API SF/CC и API SE/CC. | 1989-1993 | высшее для четырехтактных моторов |
SF | Автомобильные масла данной категории предназначены для двигателей моделей 1988 года и старше. Топливо — этилированный бензин. Они имеют более эффективные, чем предыдущие категории, противоокислительные, противоизносные, антикоррозийные свойства и обладают меньшей склонностью к образованию высоко- и низкотемпературных отложений и шлака. Автомобильные масла API SF заменяют масла API SC, API SD и API SE в более старых двигателях. | 1981-1988 | высшее для двухтактных моторов |
SE | Высокофорсированные двигатели, работающие в тяжелых условиях. | 1972-1980 | высшее |
SD | Среднефорсированные двигатели, работающие в тяжелых условиях. | 1968-1971 | среднее |
SC | Двигатели, работающие с повышенными нагрузками. | 1964-1967 | — |
SB | Двигатели, работающие при умеренных нагрузках, используется только по требованию производителя. | — | — |
SA | Двигатели, работающие в легких условиях, используется только по требованию производителя. | — | — |
Для дизельных двигателей — классы масел по шкале C | |||
Группа масел | Рекомендуемая область применения | Годы выпуска автомобилей | Качественные показатели |
CJ-4 | Введена в 2006. Для быстроходных четырёхтактных двигателей, проектируемых для удовлетворения норм по токсичности отработавших газов 2007 года на магистральных дорогах. Масла CJ-4 допускают использование топлива с содержанием серы вплоть до 500 ррт (0,05% от массы). Однако работа с топливом, в котором содержание серы превышает 15 ррт (0,0015% от массы), может сказаться на работоспособности систем очистки выхлопных газов и/или интервалах замены масла. Масла CJ-4 рекомендованы для двигателей, оборудованных дизельными сажевыми фильтрами и другими системами обработки выхлопных газов. Масла со спецификацией CJ-4 превышают рабочие свойства CI-4, CI-4 Plus, CH-4, CG-4, CF-4 и могут применяться в двигателях, которым рекомендуются масла этих классов. | с 2006 | — |
СI-4 | Введена в 2002 году. Для быстроходных четырёхтактных двигателей, проектируемых для удовлетворения нормам по токсичности отработавших газов, осуществляемым в 2002 году. Масла СI-4 допускают использование топлива с содержание серы вплоть до 0,5% от массы, а также применяются в двигателях с системой рециркуляции отработанных газов (EGR). Заменяет CD, СЕ, CF-4, CG 4 и СН-4 масла. В 2004 году была введена дополнительная категория API CI-4 PLUS. Ужесточены требования к сажеобразованию, отложениям, вязкостным показателям, ограничение значения TBN. | с 2002 | — |
СH-4 | Введена в 1998 году. Для быстроходных четырёхтактных двигателей, удовлетворяющих требования по токсичности выхлопных газов, введенных в США с 1998 года. Масла СН-4 позволяют использовать топливо с содержанием серы вплоть до 0,5% от массы. Можно использовать вместо CD, СЕ, CF-4 и CG-4 масел. | с 1998 | — |
СG-4 | Введена в 1995 году. Для двигателей быстроходной дизельной техники, работающей на топливе с содержанием серы менее чем 0,5%. Масла CG-4 для двигателей, выполняющих требования по токсичности отработанных газов, введенные в США с 1994 года. Заменяет масла CD, СЕ и CF-4 категорий. | с 1995 | высшее для моделей с 1995 г. |
СF-4 | Введена в 1990 году. Для быстроходных четырехтактных дизельных двигателей с турбонаддувом и без него. Можно применять вместо CD и СЕ масел. | с 1990 | высшее для четырехтактных моторов |
СF-2 | Введена в 1994 году. Улучшенные характеристики, используется вместо CD-II для двухтактных двигателей. | с 1994 | высшее для двухтактных моторов |
CF | Введена в 1994 году. Масла для внедорожной техники, двигателей с разделительным впрыском, в том числе работающих на топливе с содержанием серы 0,5% от массы и выше. Заменяет масла CD. | с 1994 | — |
CE | Высокофорсированные перспективные двигатели с высоким турбонаддувом, работающие в тяжелых условиях, может использоваться вместо масел классов CC и CD. | с 1987 | высшее |
CD | Класс масел для скоростных дизельных двигателей с турбонаддувом и высокой удельной мощностью, работающих на больших скоростях и при высоких давлениях и требующих повышенных противоиносных свойств и предотвращения образования нагара. | с 1955 | среднее |
CC | Высокофорсированные двигатели (в том числе с умеренным наддувом), работающие в тяжелых условиях. | с 1961 | низкие |
CB | Среднефорсированные двигатели без наддува, работающие при повышенных нагрузках на сернистом топливе. | 1949-1960 | — |
CA | Двигатели, работающие при умеренных нагрузках на малосернистом топливе. | 1940-1950 | — |
Универсальные масла для бензиновых двигателей и дизелей имеют обозначения обеих категорий, например API SG/CD, API SJ/CF.
Классы дизельных масел подразделяются дополнительно для двухтактных (CD-2, CF-2) и четырехтактных дизелей (CF-4, CG-4, СН-4).
В настоящее время API сертифицирует моторные масла классов SJ, SL, CF, CF-2, CF-4, CG-4, СН-4. Масла остальных классов по API, отмененных в США, следует использовать, если они допущены производителями автомобилей.
Знаки API
Масла, соответствующие требованиям действующих категорий качества и прошедшие официальные испытания API — SAE, имеют на своих этикетках графический круглый знак (donut mark) — «API символ обслуживания» (API Service Symbol), в котором указаны степень вязкости по SAE, категория качества и назначения по API и возможная степень энергосбережения.
Масла, лицензированные API и отвечающие API SN отображаются на заднем лейбле сервисным символом «кольцо» API. Сведения о том, что лицензированное масло также отвечает обозначению Resource Conserving, изображены на нижней части кольца.
Новейшие категории масел сертифицированные API, в случае соответствия требованиям ILSAC, обозначаются «Символом Свидетельства сертификации API» (API Certification Mark), так называемым знаком «Звездного взрыва» («Starburst»). Этот знак может присваиваться только энергосберегающим, легкотекучим маслам наивысшего уровня качества, с вязкостями SAE 0W-…, 5W-… и 10W-… . Система требований к маслам серии ILSAC GF является составной частью системы API Обеспечения Качества Американских Масел (EOLCS).
Системы API — ILSAC предназначены для удовлетворения требований к маслам, используемым в двигателях американских и японских автомобилей. Требования европейских автопроизводителей несколько отличаются по причине конструктивных особенностей европейских двигателей. Несмотря на это, большинство моторных масел, поступающих на европейский рынок, маркируются знаками соответствия категориям качества API и, в редких случаях, даже «Символом Обслуживания API» (API Service Symbol).
Общие сведения об API таблиц Azure Cosmos DB
- Чтение занимает 3 мин
В этой статье
ПРИМЕНИМО К: API таблиц
Azure Cosmos DB предоставляет API таблиц для приложений, созданных для хранилища таблиц Azure и требующих таких возможностей уровня «Премиум», как:
С помощью API таблицы вы можете перенести приложения, написанные для хранилища таблиц Azure, в Azure Cosmos DB, не изменяя код, и воспользоваться возможностями уровня «Премиум». API таблицы включает клиентские пакеты SDK для .NET., Java, Python и Node.js.
Важно!
Библиотека Microsoft.Azure.CosmosDB.Table пакета SDK для .NET Framework находится в режиме обслуживания. Ее поддержка скоро будет прекращена. Выполните обновление до новой библиотеки .NET Standard Microsoft.Azure.Cosmos.Table, чтобы и дальше получать последние функции, которые поддерживает API таблиц.
Сравнение возможностей хранилища таблиц и API таблицы
Если вы сейчас используете хранилище таблиц Azure, при переходе на API таблицы Azure Cosmos DB вы получите следующие преимущества:
Компонент | табличное хранилище Azure; | API таблиц Azure Cosmos DB |
---|---|---|
Задержка | Низкая, без максимального ограничения по задержке. | Задержка операций чтения и записи (доступно при любых объемах по всему миру): менее 10 мс для операций чтения и записи на уровне 99-го процентиля. |
Пропускная способность | Модель с переменной пропускной способностью. Ограничение масштабируемости таблиц — 20 000 операций в секунду. | Высокомасштабируемая с выделенной зарезервированной пропускной способностью на каждую таблицу в соответствии с соглашениями об уровне обслуживания. Учетные записи не имеют максимального ограничения пропускной способности и поддерживают выполнение более 10 млн операций в секунду на таблицу. |
Глобальное распределение | Один регион с отдельным дополнительным регионом вторичных реплик для чтения для высокого уровня доступности. | Комплексные возможности глобального распределения между любым количеством регионов. Поддержка автоматической отработки отказа и отработки отказа вручную в любое время повсеместно. Несколько регионов записи с возможностью выполнения операций записи в каждом из них. |
Индексация | Поддержка только первичного индекса для свойств PartitionKey и RowKey. Вторичные индексы не поддерживаются. | Поддержка автоматического и полного индексирования всех свойств по умолчанию без необходимости управления индексами. |
Запрос | При выполнении запроса используется индекс для первичного ключа. В противном случае — сканирование. | Для ускорения выполнения запросов может использоваться автоматическая индексация свойств. |
Согласованность | Строгая согласованность в основном регионе. Итоговая согласованность в дополнительном регионе. | Поддержка пяти точно определенных уровней согласованности с возможностью изменять показатели доступности, задержки, пропускной способности и согласованности в соответствии с потребностями приложений. |
Цены | На основе потребления. | Доступно в режимах на основе потребления и подготовленной емкости. |
Соглашения об уровне обслуживания | Доступность от 99,9 % до 99,99 % в зависимости от стратегии репликации. | 99,999 % доступность для операций чтения, 99,99 % доступность для операций записи в учетной записи с одним регионом и 99,999 % доступность для операций записи в учетных записях с несколькими регионами. Полный спектр соглашений об уровне обслуживания, которые охватывают такие аспекты, как уровень доступности, задержка, согласованность и пропускная способность. |
Начало работы
Создайте учетную запись Azure Cosmos DB на портале Azure. Затем приступите к работе, ознакомившись со статьей Azure Cosmos DB. Создание приложения .NET с помощью API таблицы.
Важно!
Если вы создали учетную запись API таблиц на этапе работы с предварительной версией, для работы с общедоступными пакетами SDK для API таблиц создайте новую учетную запись.
Дальнейшие действия
Ознакомьтесь с приведенными ниже ресурсами:
таблица для бензиновых двигателей и дизелей
Существующая спецификация АПИ (Американский Институт Нефти) разделяет автомасла на три группы. Классификация масел по API относится к бензиновым, дизельным смесям и лубрикантам, предназначенным для современных двигателей.
Состоянием на 2021 год классификатор организации насчитывает 12 распространенных стандартов, разбитых на категории относительно их эксплуатационных свойств.
Классификация масел и их обозначение по API
Класс автомасла по системе АПИ представляет собой последовательность стандартов, введенных в хронологическом порядке. Каждая категория, применяемая для дизельных или бензиновых агрегатов обозначается буквой S или С соответственно.
При выпуске обновленного норматива к первой части добавляется буква из латинского алфавита: SA, SB, SC, SD, SE, SF, SG, SH, SJ, SL, SM, SN. Либо в случае с дизелями: СA, СB, СC, СD, CE, CF, CF-2, CF-4, CG-4, CH-4, CI-4.
Понять какой уровень лубриканта перед покупателем просто. Согласно хронологии, чем дальше вторая буква от начала алфавита, тем качественнее продукт и чище формула базовых масел использована.
Расшифровка значений выглядит в форме таблицы.
API категории S для бензиновых двигателей
Для моторов на бензиновой тяге используется маркировка стандарта АПИ с индексом S. Это отдельное подразделение, где собраны основные стандарты и нормы спецификации в хронологической последовательности их ужесточения.
SN — 2010 ТО бензинового двигателя
Передовой стандарт, введенный для ужесточения ограничений по содержанию в масле фосфора и его составляющих. Здесь должны отсутствовать элементы, способные снизить общую энергоэффективность продукта.
Благодаря требованиям, масла категории можно заливать в высокофорсированные двигатели, оборудованные передовыми устройствами очистки выхлопа. Дополнительно присутствует совместимость с установками, потребляющими природный газ.
SM — 2004 ТО бензинового двигателя
Менее жесткая норма регулирует содержание вредных примесей, способных навредить окружающей среде, автомобилю. Масла группы могут стабильно использоваться в моторах, где имеются каталитические нейтрализаторы, турбонаддув, многоклапанные системы подачи топлива.
SL — 2001
Первый класс, где были глубоко внедрены требования экологической безопасности. Норма требует частичного снижения вредных выбросов, уменьшение энергозатрат и экономию топлива.
SJ — 1997
Самая старая, актуальная в 2021 году серия. Здесь присутствует повышенная, относительно прошлых поколений чистящая способность лубриканта, увеличенное количество щелочей в составе.
Смазки можно заливать в гоночные машины 20 века, где имеется высокофорсированный двигатель.
Таблица для дизельных двигателей
Для солярочных моторов актуальны 7 стандартов качества.
API | Обозначение |
CF | Норматив работает с 1994 года и характеризует масла, используемые для ухода за моторами, оборудованными раздельным впрыском топлива. Здесь не используются очистители выхлопа или нагнетатели. Смеси совместимы с сернистыми породами горючего. |
CF-2 | Ровесник прошлого стандарта. Применяется на двухтактных ДВС. |
CF-4 | Актуален с 1990 г. описывает лубриканты, предназначенные для работы с турбонаддувом и без, в высокооборотистых агрегатах. |
CG-4 | Акт представлен в 1995 году и представляет собой ужесточенный формат прошлого поколения. Формулы способны работать с соляркой с примесью серы до 0,5% от общей массы. |
СН-4 | Вступил в силу с 1998 г. более жесткие требования к экологичности выхлопа, может эксплуатироваться с дизелем до 0,5 % серы в составе включительно. |
CI-4 | Обновление 2002 года. Лубриканты можно заливать в ДВС оборудованные рециркуляторами выхлопа, строгие требования к образованию сажи, сульфатной золе. Заменяет собой предшествующие документы. |
CJ-4 | Самая современная версия спецификации. Жидкости рекомендуются для заливки в транспорт, оборудованный сажевыми фильтрами и другими, существующими системами очистки выхлопа. Требование к топливу – до 0,05% серы. |
Таблица для бензиновых двигателей
Для бензиновых смазок актуальные спецификации на 2021 год свои.
Примечание! Отечественные производители типа Лукойл или Роснефть, также обязаны иметь соответствие сертификатам.
Из 11 существующих актов, сегодня актуально только 5.
API | Описание |
SН | Норматив 1995 года, характеризует формулы, подходящие для заливки в более старые моторы. Спецификация гарантирует умеренную топливную экономичность и совместимость с турбонаддувом. |
SJ | Требование применяется для ДВС выпускаемых до 2001 года. Отличаются от устаревших норм, чистотой выхлопа и стойкостью к термическому окислению. |
SL | Норма введена для моторов до 2004 г включительно. Ужесточены требования к стабильности энергосбережения, и внедрена совместимость с увеличенными межсервисными интервалами до 15000 км пробега. |
SM | Жесткая норма, вступившая в силу в 2005 г. относительно ранних модификаций повышена стойкость к температурному окислению, увеличен межсервисный интервал. Некоторые разновидности лубрикантов являются энергосберегающими. |
SN | Последний стандарт, введенный в 2010 году и состоянием на 2021 г. является самым последним. Здесь усилены требования к качественным показателям, и сроку службы. Можно заливать в современные гоночные автомобили и другую технику. 90% подходящих формул являются энергоэффективными. |
API категории C для дизельных двигателей
Отдельная группа применима только для дизелей различного типа.
Категория обслуживания API CK-4
Дизельная категория, предназначенная для самых современных моторов, произведенных после 2017 года и требующих заливки специфического масла.
Здесь используются более качественные компоненты, относительно устаревших стандартов. Жидкости СК-4 обратно совместимы с устаревшими лубрикантами.
API CJ-4 2006
Стандартный допуск для магистральных автомобилей с быстроходными дизельными двигателями. Масла категории не могут применяться на территории СНГ, что обусловлено повышенным содержанием серы в дизельной горючке. Максимальное количество примеси вещества — 0,005%.
Благодаря жестким требованиям жидкости группы могут полноценно применяться в ДВС, где установлены передовые системы очистки выхлопа.
API CI-4 Plus 2004
Норма повышает требования стандарта без индекса плюс. Здесь увеличена стойкость масла к сдвигу, изменению вязкости при попадании сажи. Дополнительно внедрена технология, уменьшающая испаряемость смазки.
Используются для быстроходных грузовиков, автобусов, тягачей, эксплуатируемых на магистралях.
API CI-4 2004 (для дизельных двигателей с повышенной нагрузкой)
Ожидаемое обновление стандарта 2002 года. Здесь присутствует ужесточение параметров относительно холодной прокачки при отрицательны температурах. Дополнительно имеется список ограничений по угару смазки.
Масла выделяются увеличенной моющей способностью, благодаря содержанию высокоактивных щелочных присадок.
API категории TC для двухтактных двигателей
Стандарт подразумевает эксплуатацию масел в моторах, объемом от 0,2 до 0,5 литра.
Для получения допуска лубриканты должны пройти тестирование на сохранность колец поршневой группы, образование задир, нагара. Также требуется соблюдение ограничений по детонации и преждевременному зажиганию топливной смеси.
Важным параметром является недопустимость эксплуатации в подвесных двигателях водной техники.
API категории EC – энергосберегающие масла
Новая в группе спецификация, куда входят легко текучие смазки с минимальной низко и высокотемпературной вязкостью. Продукты преимущественно используют в энергосберегающих установках последнего поколения. Без допуска производителя эксплуатация лубрикантов запрещена.
По эффективности смеси разделяются на несколько категорий. Обозначение подгруппы указывается после буквенного индекса и говорит о степени экономии горючего:
- ЕС – 1,5%;
- ЕС2 – не менее 2,5%.
Классификация API для небольших моторов
Стандарт «ТВ» предназначен для структурирования лубрикантов, предназначенных для обслуживания легкомоторной техники:
- скутеров;
- мопедов;
- картов;
- строительных и сельскохозяйственных агрегатов;
- мотоблоков.
Масла подходят на ДВС двухтактного типа, что гарантирует минимальную зольность, отличные моющие показатели.
Классификация API для трансмиссионных масел
Состоянием на 2021 год классификация насчитывает 5 уровней лубрикантов с различным уровнем защитных свойств.
- GL-1 – первое поколение лубрикантов, обладающее минимальным набором полезных свойств и присадок. Смеси больше эксплуатируются на мало ответственных агрегатах, где нет повышенной нагрузки.
- GL-2 – более новая форма, повышающая требования к моющим присадкам, увеличивая их количество и агрессивность.
- GL-3 – достаточно распространенная спецификация, востребованная среди любителей классических автомобилей, где используются чувствительные детали. Область применения – мосты, механические КПП, редукторные блоки.
- GL-4 – последняя группа, применимая для заливки в МКПП с установленными синхронизаторами из латуни, бронзы или меди. В стандарте повышена прочность масляной пленки, внедрены передовые разработки.
- GL-5 – самая последняя из актуальных модификаций. Масла преимущественно заливают в современные трансмиссионные блоки. Важным фактором является недопустимость использования в коробках передач, оборудованных синхронизаторами из цветных металлов – жидкость имеет ряд агрессивных присадок, наносящих вред блокам.
Подбор масла по классификации API
Отличия моторов сами рассказывают о том, какую категорию необходимо применять для конкретного автомобиля. Подбор лубриканта осуществляется исходя из года выпуска и конструкции ДВС. К примеру, для машины 2001 года с турбированным дизельным двигателем, где имеется система рециркуляции, подойдет жидкость типа CI-4 или выше.
Классификация моторных масел по SAE
Спецификация SAE представляет собой документ, разделяющий автомасла по группам, относительно порогов эксплуатации. Для моторных масел применяется таблица J300, где указана каждая степень вязкости и ее рабочий диапазон. Всего существует три категории:
- зимняя;
- летняя;
- универсальная
Особенность нормы в том, что разработана она в едином варианте для дизельных и бензиновых лубрикантов, при этом основа продукта не играет роли, будь то синтетика или минералка.
Примером стандарта может послужить популярная маркировка SAE 5W30. Эта группа распространена в умеренном климате стран СНГ. Рабочий диапазон температур составляет от -25 до +30 градусов Цельсия.
Классификация моторных масел по ACEA
Стандартная спецификация, образованная в 1991 году европейскими производителями с целью систематизации смазочных материалов. В марте 2008 г, произошел пересмотр спецификаций в угоду обновившимся экологическим нормам.
Состоянием на 2021 год выделяются категории СМ:
- А – бензиновые;
- В – дизельные;
- С – бензиновые и солярочные моторы с системами очистки выхлопа;
- Е – грузовые дизеля.
Нет жесткого распределения легкомоторной техники по типу установки. Спецификации указываются вместе.
- А1/В1 – универсальные смазки со стандартным межсервисным интервалом. В настоящее время практически не применяются.
- А3/В3 – стандартные лубриканты, подходящие для современных и классических моторов, оборудованных сажевыми фильтрами.
- А3/В4 – более жесткая норма, характеризует формулы, приспособленные для работы с непосредственным впрыском и турбированными, высоко нагруженными моторами.
- А5/В5 – самая жесткая норма, куда подпадают смазки, способные экономить топливо и работать при длительных интервалах замены.
Далее на очереди группа автомасел, которые обозначаются индексом С и могут заливаться в ДВС с установленными системами дожигания и очистки выхлопа.
- С1 – энергосберегающие жидкости с низким содержанием серы;
- С2 – аналогичное масло со средним содержанием серы;
- С3 – формулы могут работать с сажевыми фильтрами нового образца;
- С4 – самая передовая группа выделяет автомасла с пониженным содержанием несгораемых примесей, что допускает их эксплуатацию в самых передовых агрегатах.
Также у организации присутствуют энергосберегающие масла:
- Е4 – применимы для ДВС с установленными рециркуляторами, где также актуален допуск Лонг Лайф;
- Е6 – сфера эксплуатации высокофорсированные моторы дизельного типа;
- Е7 – выставлены дополнительные требования к уменьшению сульфатной хольности, совместимости с устройствами турбонаддува;
- Е9 – предельный уровень защиты мотора от образования шламов, нагара. Жидкости подходят для высокофорсированных аппаратов, питаемых соляркой.
Классификация моторных масел по ILSAC
Международная классификация американских и европейских производителей автомасел также выставляет ряд требований к выпускаемым смазкам. Цель пакета документов – ужесточить регламенты и производственные процессы. Примечательным является то, что спецификация является условно «дочерним предприятием» API так как создавалась на ее основе.
Здесь присутствует ряд спецификаций:
- GF – 1. Устаревший на 2021 год стандарт.
- GF – 2. Норма применима для машин, произведенных после 1997 г. Дополняет пакет требований APISG.
- GF -3. Маркировка смазок ужесточает требования к экологическим параметрам выхлопа, производительности установки под критическими перегрузками.
- GF – 4. Нормативный акт минимизирует количество фосфора в формуле лубриканта, увеличивает срок эксплуатации жидкости.
- GF – 5. Предельная длительность эксплуатации смазок, и полная совместимость с био топливом. Норматив позволяет максимально увеличить интервал замены жидкости.
Классификация моторных масел и их обозначение по ГОСТ: таблица
Отечественные автомасла всегда обозначены согласно требованиям ГОСТ 17479,1-85. Этот норматив обязывает изготовителей устанавливать на продукцию строгие маркировки.
Обозначение | Расшифровка |
А | Используется на атмосферниках |
Б | Предназначено для двигателей минимального форсирования |
В | Для моторов умеренно форсированных |
Г | Высокофорсированные агрегаты бензинового типа |
Д | Высоконагруженные дизеля, оборудованные интенсивным наддувом |
Е | Группа, предназначенная для тихоходных установок, работающих на солярке, чье применение не затрагивает автомобили. |
После буквы может стоять цифра 1, что говорит о принадлежности исключительно к дизельным моторам.
Также присутствуют другие обозначения в шифровке.
Для удобства можно привести пример расшифровки масла М6з/10В в табличной форме.
Часть индекса | Расшифровка |
М | тип обслуживаемого механизма, М – моторы |
6 | Кинематическая вязкость при +100 °С (сСт) |
З | Применяются загустители |
10 | Принудительное повышение густоты благодаря добавленной присадке (масло всесезонное) |
В | Продукт разработан для обслуживания среднефорсированных ДВС, независимо от типа мотора. |
На что влияет неправильный выбор моторного масла
Если смазку подобрали неправильно – это вызовет ряд негативных последствий.
- Снижение производительности и срока эксплуатации установки.
- Засорение картера шламами, сажей.
- Затруднение холодного пуска зимой.
- Стук гидрокомпенсоторов и клапанов.
- Образование течи смазки. Неправильно подобранный лубрикант может разрушить сальники и уплотнители.
Классификация характеристик моторных масел: API, SAE, ACEA таблицами
Содержание статьи:От правильного выбора масла зависит долговечность работы двигателя – банально, но факт. Если залить неправильное масло, двигатель не откажется работать сразу, но это скажется на его пробеге, ресурс работы деталей снизится значительно. Когда автоиндустрия достигла определенного уровня, возникла необходимость классифицировать все разнообразие масел. В результате приняли стандарты по определенным признакам, которые используют во всем мире:
- SAE – Общество автомобильных инженеров.
- API – Американский институт нефти.
- ACEA – Ассоциация европейских производителей автомобилей.
- ILSAC – Международный комитет по стандартизации и апробации моторных масел.
Отечественная промышленность классифицирует свои масла еще и по старой доброй сертификации ГОСТ, но также продукция получает сертификаты и по международным стандартам.
Классификация моторных масел по SAE
Характеризует вязкость масла при разных температурах окружающей среды. То есть она определяет, в какой сезон можно использовать смазку. Если вязкость масла подходит для текущей температуры, то оно будет сохранять текучесть, оставаться на деталях автомобиля и сохранять свою смазочную способность. Если же нет, то начинается обратный эффект – двигатель работает практически «на сухую» или вообще не заводится. Производитель автомобиля регламентирует подходящие SAE, водителю остается только выбрать в предложенном диапазоне по сезону:
- Зимние – 0W, 5W, 10W, 15W, 20W, 25W;
- Летние – 20, 30, 40, 50, 60;
- Всесезонные масла с двойным индексом: 0W-30, 5W-40 и тд.
Указанные параметры важны именно при пуске автомобиля, так как определяют способность масла прокачаться по всем каналам и обеспечить безопасный пуск коленвала. Главная характеристика для зимних смазок – вязкость при отрицательных температурных показателях, именно она обеспечивает проворачиваемость и прокачиваемость. Вязкость проворачивания в мороз измеряют по методу ASTM D5293 на вискозиметре CCS, показывает соответствие масла безопасному значению, которое позволит коленчатому валу развить необходимую для пуска частоту вращения.
Еще один показатель – вязкость прокачиваемости, определяют по методу ASTM D4684 на вискозиметре MRV, показывает, соответствует ли масло безопасному значению, при котором оно прокачается, предотвращая сухой пуск мотора. Верхний порог показателя 60 000 мПа*с.
Для применяемых в теплое время года смазок измеряется минимальный и максимальный порог кинематической вязкости при температуре 100 и 40 градусов, при минимальной динамической вязкости в пределах температуры 150 градусов и скорости сдвига 106с-1. Всесезонные соответствуют всем требованиям.
Следует понимать, что выбор масла с самым высоким летним показателем не даст двигателю дополнительную мощность, но обеспечит его защиту при высоких нагрузках. Существуют линейки спортивных масел с высоким индексом вязкости – SAE 5W-50 и SAE 10W-60. В спортивных двигателях температуры выше, чем в обычных, им необходимы повышенные характеристики для обеспечения прочности масляной пленки при больших нагрузках и сохранения вязкости масла. То есть увеличена температура кипения, показатель кинематической и динамической вязкости.
Классификация SAE для трансмиссионных масел
Для трансмиссионных масел предусмотрена собственная классификация, смазки попадают под 7 категорий – 4 зимние с индексом W, и 3 летних. Для всесезонных масел предусмотрена двойная маркировка по аналогии с моторными маслами.
Классификация моторных масел по API
Учитывает тип ДВС, особенности конструкции и условия использования, возраст. Стандарт постоянно обновляется, охватывая самые новые модели и учитывая их потребности. Всего в нем 4 категории, разделенные на классы двойным буквенным индексом, первая буква показывает применяемость в бензиновых (S), дизельных (C), двухтактных (T) моторах и энергосберегающие масла (EC). Вторая показывает эксплуатационные качества. Самый устаревший класс обозначается буквой А, далее идут более новые. Новый класс может заменить старый: SM вместо SL, SN вместо SM и так далее.
API категории S для бензиновых двигателей
Маркировка | Характеристика | Применяемость | Примечания |
---|---|---|---|
SN | Малое количество фосфора в составе | Совместимо с нейтрализаторами выхлопа | Энергосберегающие свойства. Эквивалентна ILSAC, с той разницей, что требования API SN не требуют тест износостойкости на состаренных маслах по методике Sequence IIIG и тест энергоэффективности по Sequence VID. |
SM | Лучшие показатели защиты деталей и окисления | Транспорт от 2003 г.в. | Экологично, энергосберегающее. |
SL | Сниженная испаряемость | Транспорт от 2000 г.в. использующий обедненное топливо | Длительный период эксплуатации |
SK | Не используется, один корейский производитель масла использует такое сокращение для имени своей корпорации, во избежание путаницы литера «K» была исключена из классификации. | ||
SJ | Поддерживает чистоту внутреннего пространства мотора. | Транспорт от 1996 г.в. | Сохранение характеристик при сниженных температурах |
SH | Поддерживает чистоту внутреннего пространства мотора. | Транспорт от 1996 г.в. | На данный момент действует только условно. Соответствует ILSAC GF-1, кроме энергосбережения и экономии топлива, последней являются обязательными. |
SG | Повышенные показатели стойкости к коррозии. | Транспорт от 1989 г.в. | Класс прекратил свое действие в 1995 году. |
API SF, SE, SD, SC, SB, SA являются уже не актуальными, заменяются классами выше, применяются в очень редких случаях, если есть особая рекомендация для двигателя.
API категории C для дизельных двигателей
Маркировка | Характеристики | Применяемость | Примечания |
---|---|---|---|
CJ-4 | Ограничения по золе (менее 1,0%), серы (0,4%), фосфора (0,12%). | Двигатели от 2007 г.в. с сажевыми фильтрами и системами, очищающими выхлоп. | Отвечает нормам по выделению NOx и твердых частиц. |
CI-4 PLUS | Увеличенные экологические показатели и эксплуатационные характеристики. | Дополнительный класс, начал действие в 2004 году. | Сниженное количество сажи, увеличенный параметр окисления при высоких нагрузках, низкая испаряемость. |
CI-4 | Сниженное количество фосфора и серы. | Для очищающих выхлоп систем и больших нагрузок. | Высокая экологическая безопасность, начал действие в 2006 году. |
CH-4 | Меньшее количество нагара. | Для работы при высоких оборотах и топлива с серой до 0,5%. | Ужесточенные экологические требования, начал действие в 1998 году. |
CG-4 | Сниженное количество сажи, способности к окислению и пенообразованию. | Для автобусов, грузовых машин и тягачей магистральных и немагистральных, работающих с большой нагрузкой. Применяется в нетребовательных к качеству дизеля с серой до 0,5% ДВС. | Ужесточенные экологические требования. Начал действие в 1995 г. |
CF | Обеспечивает чистоту деталей. | Агрегаты с непрямым впрыском, не требовательные к качеству дизеля или работающие на топливе с количеством серы до 0,5%. Подходит для масляныaх систем с турбонагнетателем или компрессором. | CF-2 – двухтактные двигатели. CF-4 – четырехтактные, для сверхмощных тягачей и аналогичного транспорта, работающего на автомагистралях в поездках на дальние расстояния. Может иметь сдвоенный класс: API CF-4/S, в таком случае заливается и в бензиновые моторы при наличии рекомендаций. |
CE | Сниженная способность окисляться и пениться. | Для транспорта от 1983 г.в. | Класс действует только условно, заменяется более поздними. |
Устаревшие классы: CE, CD-II (CD-2), CD+, CD, CC, CB, CA. Не используются.
API категории TC для двухтактных двигателей
API TD. Лодочные моторы. Классы TC и TD параллельны и не взаимозаменяемы.
API TC. Для требовательных к качеству масла механизмов – мотоциклы, снегоходы и т.д. Используется вместо API TA и TB.
API TB. Для работающих на больших скоростях и с нагрузкой моторов с объемом 50-200 см3.
API TA. Для ДВС до 50 см3 и воздушным охлаждением.
API категории EC – энергосберегающие масла
Категория EC используется для автобусов, грузовиков, легковушек и спецмашин. Состоит из легкотекучих фракций с низким показателем вязкости, чем снижает расход топлива.
Данная маркировка проставляется вместе с категорией эксплуатационных свойств: API CI-4 (ECI). Возможная экономия топлива просчитывается в сравнении с эталонной вязкостью SAE 20W-30:
- EC I – до 1,5%.
- EC II – до 2,5%.
Свои свойства масло показывает только на полностью исправном агрегате, эксплуатируемом в режиме города, экономия в таком режиме доходит до 5%. Повысить показатель можно и использованием экономичного масла для трансмиссии.
Классификация трансмиссионных масел по API
Для трансмиссии стандарт API разработал собственные 6 групп, они делят продукцию по применению, типу зубчатой передачи, нагрузкам в зонах сцепления и максимально допустимого температурного показателя. Пересекается с существующими в нашей стране стандартами ГОСТ, потому их целесообразно совместить в одну таблицу.
API | ГОСТ | Характеристики и подходящие конструкции |
---|---|---|
GL2 | ТМ-1 | Минеральная база без добавления присадок или с компонентами, уменьшающими окисление и пенообразование, без противозадирных. Используется в ручных коробках с малыми показателями удельного давления и скорости скольжения. Передачи цилиндрические, червячные, спирально-конические зубчатые. |
GL2 | ТМ-2 | Червячные передачи, используемые в условиях, описанных для класса GL-1, но с повышением требований к антифрикционным качествам. |
GL3 | ТМ-3 | Большое количество присадок со свойствами на уровне MIL-L-2105. Совместимо со ступенчатыми коробками и рулевыми механизмами, главными передачами и гипоидными с небольшим смещением. Спирально-конические передачи и стандартные трансмиссии со спирально-коническими шестернями, используемые в умеренно жестко. В отличие от GL-2 имеет лучшие защитные свойства. |
GL4 | ТМ-4 | Аналогична GL-3, отличие только в обязательном наличии противозадирных компонентов. |
GL5 | ТМ-5 | Предпочтительно для гипоидных передач с уровнем MIL-L-2105 C/D, с гипоидными коническими зубчатыми колесами и коническими колесами с круговыми зубьями для главной передачи в автомобилях и карданных приводах мотоциклов и ступенчатых коробках передач мотоциклов. Оптимально для больших нагрузок с ударной и знакопеременной нагрузкой. Гипоидные конструкции с работой при высоких скоростях, малых крутящих моментах и ударных нагрузках на зубья шестеренок. В состав обязательно входят содержащие серу и фосфор противозадирные компоненты. Может иметь более широкую сферу применения, это указывается производителем в технической документации. |
GL6 | ТМ-6 | Гипоидные передачи с увеличенным смещением, эксплуатируемые при больших скоростях, крутящих моментах и ударных нагрузках. Обязательны в большом количестве вещества с серой и фосфором, предупреждающие образование задиров, их число превышает таковое в GL-5. Сейчас группа практически не используется. |
АКПП классифицируются по своим группам, которые не подчиняются требованиям API, для них необходимы особенные технические характеристики. Крупнейшие производители агрегатов создали собственную спецификацию – ATF. На сегодняшний день это две группы:
- Для агрегатов «Дженерал моторс», Dexron, Dexron II, III и Allison, в эту же группу подходят коробки ZF.
- Для агрегатов «Форд», Mercon, V2C 138-CJ и M2C 166H.
Классификация моторных масел по ACEA
Организация образована в 1991 году вместо существовавшей до этого CCMC. До конца 1996 года ACEA действовала параллельно с API. Первая редакция классификаций масел вышла в 1994 году, после чего много раз пересматривалась и переиздавалась. Каждая новая редакция имеет аббревиатуру с годом ее издания, например, ACEA 2008.
После выхода новых спецификаций старые действуют еще два года параллельно с новыми, чтобы дать время производителям масел перестроиться на новые требования. Более старые редакции после этого считаются недействительными и, если какой-то производитель ссылается на них, он относится к тем, кто не прошел новую спецификацию. На сегодняшней день актуальной является спецификация ACEA 2012.
Категории масел ACEA
В последней редакции 2012 года выделены три категории:
ACEA A/B – Смазки для моторов с питанием бензином и дизелем. Объединяет все разработанные до 2004 года классы A и B, которые в более ранних редакциях делили смазки на две категории по типу топлива. Сейчас в этой категории 4 класса: А1/B1, A3/B3, A3/B4, A5/B5.
Класс | Применение | Характеристики |
---|---|---|
А1/В1 | Для определенной категории двигателей с небольшой нагрузкой, в которых можно применять маловязкие масла. | Имеет увеличенный пробег, не рекомендовано для жаркого климата. Энергосберегающее. |
А3/В3 | Для двигателей легковых авто и грузовиков малого тоннажа с высокой мощностью, с турбонаддувом и без | Средний интервал замены. Может использоваться в любой сезон. |
А3/В4 | Для агрегатов с турбиной, непосредственным впрыском и насос-форсунками или системой Common Rail. | Практически полностью идентично А3/В3, но подходит для новых инжекторных систем. Может заменить предыдущую категорию. |
А5/В5 | Для высокофорсированных моторов легкого транспорта, где допускается использование смазок малой вязкости. | Маловязкое, подходит для зимних месяцев. Не подходит к некоторым типам двигателей. |
ACEA C – смазки для бензинового и дизельного топлива, подходят под самые жесткие современные требования экологов по содержанию веществ в выхлопе. Можно использовать в системах с катализаторами и сажевыми фильтрами, так как имеют сниженную зольность. В этой категории 4 класса: C1, C2, C3, С4.
Класс | Применение | Характеристики |
---|---|---|
С1 | Бензиновые и дизельные двигатели с инжекторами, мощные с малым зазором между внутренними деталями. | Экономит топливо и распадается до нейтральных веществ в выхлопе. Не допускается использовать в устаревших конструкциях или двигателях, в которые ранее заливались более агрессивные материалы. |
С2 | Экономные двигатели с системами очистки выхлопа. | Отличие от предыдущей категории в более высоком содержании фосфатов и сульфатов. |
С3 | Моторы с системами очистки выхлопа, работающие в сложных условиях, с турбонаддувом или без. | Отличается от С2 повышенной вязкостью, низкая и средняя зольность. Подходит для увеличенных интервалов замены. |
С4 | Для систем, оборудованных сажевыми фильтрами DPF и трехкомпонентными катализаторами TWC. | По составу похож на С1, но выше вязкость. |
ACEA E – смазки для дизелей, работающих с большой нагрузкой, и тяжелого транспорта. Категория была введена в самом начале создания класса в 1995 году. В новой редакции 4 класса: Е4, Е6, Е7, Е9.
Класс | Применение | Характеристики |
---|---|---|
Е4 | Современные двигатели, отвечающие нормам Евро от 1 до 5 и работающие в тяжелых условиях. | Обеспечивает чистоту деталей и защиту от износа, длительный интервал замены. Не подходит для систем с сажевым фильтром, совместим не со всеми системами очистки выхлопа. |
Е6 | Для современных моторов, отвечающих требованиям Евро от 1 до 5 с системой очистки выхлопа, с сажевым фильтром или без, снижением выбросов оксида азота. | Обеспечивает чистоту внутренних деталей, защищает от износа, увеличенный интервал пробега. |
Е7 | Дизельные моторы, работающие на больших оборотах класс Евро от 1 до 5, оборудованных системой очистки выхлопа. Не подходит для систем с сажевым фильтром. | Повышение антиокислительных и моющих свойств. Увеличенные интервалы замены. |
Е9 | Отличие от Е7 в совместимости с сажевым фильтром. | Ограничение по зольности. |
Классификация моторных масел по ГОСТ
Классификация по ГОСТ 17479.1 была принята еще в СССР в 1985 году, но из-за меняющихся требований в автомобилестроении в 2015 году была переиздана. Соответствует международным стандартам. По вязкости делится по аналогу с SAE на:
- Летние масла – 8, 10, 12, 14, 16, 20, 24.
- Зимние – 3з, 4з, 5з, 6з, 8.
Индекс 8 зачастую используется как летний, так и зимний. Всесезонные масла обозначаются через дробь – 5з/12 и т.п.
ГОСТ | SAE | Кинематическая вязкость мм2/с, при температуре | |
---|---|---|---|
100оС | -18оС, не более | ||
3з | 5W | 13,8 | 1250 |
4з | 10W | 14,1 | 2600 |
5з | 15W | 15,6 | 600 |
6з | 20W | 15,6 | 10400 |
6 | 20 | 5,6-7,0 | |
8 | 20 | 7,0-9,3 | |
10 | 30 | 9,3-11,5 | |
12 | 30 | 11,5-12,5 | |
14 | 40 | 12,5-14,5 | |
16 | 40 | 14,5-16,3 | |
20 | 50 | 16,3-21,9 | |
24 | 60 | 21,9-26,1 | |
3з/8 | 5W/20 | 7,0-9,3 | 1250 |
4з/6 | 10W/20 | 5,6-7,0 | 2600 |
4з/8 | 10W/20 | 7,0-9,3 | 2600 |
4з/10 | 10W/30 | 9,3-11,5 | 2600 |
5з/10 | 15W/30 | 9,3-11,5 | 6000 |
5з/12 | 15W/30 | 11,5-12,5 | 6000 |
5з/14 | 15W/40 | 12,5-14,5 | 6000 |
6з/10 | 20W/30 | 9,3-11,5 | 10400 |
6з/14 | 20W/40 | 12,5-14,5 | 10400 |
6з/16 | 20W/40 | 14,5-16,3 | 10400 |
По области применения масла по ГОСТу делятся на 6 групп, обозначаемых буквами русского алфавита от А до Е. Могут иметь цифровые индексы, где 1 обозначает принадлежность к бензиновым маслам, а 2 к дизельным. Если индекса нет, значит масло универсальное и подходит для любого типа топлива. Аналогично классификации API.
ГОСТ для трансмиссионных масел
Принадлежность масел к этой категории показывает маркировка «ТМ», далее идет цифра, которая указывает на группу эксплуатационных характеристик смазки, далее цифра, указывающая вязкость. Могут использоваться дополнительные знаки, указывающие на особенные свойства масла – это строчные буквы: «рк» – рабоче-консервационные масла, «з» – с загущающей присадкой и тому подобные. То есть маркировка масла по ГОСТу может выглядеть примерно так: ТМ-5-12 (рк).
Для отечественных смазок установлено 4 класса вязкости, для каждого класса есть свои нормы пределов кинематического значения при 100оС, классы 9, 12, 18 имеют значения отрицательных температур, при которых продолжают выполнять свои функции. По назначениям и свойствам делятся на 5 групп, в которых описываются основные свойства.
Классификация моторных масел по ILSAC
У европейских изготовителей нет четкого требования соответствовать этому стандарту, он создавался для автомобилей производства США и Японии, в которые и заливаются масла этого класса. ILSAC был создан в 1992 году как результат сотрудничества Американской ААМА и японской JAMA. Классифицирует только бензиновые двигатели легковых автомобилей. Всего имеет 5 классов, на данный момент ведут работы над созданием шестого.
ILSAC | Описание | API и SAE |
---|---|---|
GF-5 | Введена в 2010 году, имеет ужесточенные требования к моющим свойствам, увеличенный срок использования. Основное отличие от предыдущих версий в совместимости с биотопливом. Может работать с нейтрализаторами выхлопа и уплотнителями. | |
GF-4 | Была утверждена в 2004 году. Имеет энергосберегающие свойства, от GF-3 отличается повышенной стойкостью к окислению, повышенными моющими свойствами и уменьшению количества отложений на деталях. Может работать в системах с катализаторами и восстановления выхлопа. | API SM, SAE 0W-20, 5W-20, 0W-30, 5W-30, 10W-30 |
GF-3 | Утверждена в 2001 году. Отличается от GF-2 повышенными противоокислительными свойствами, снижена испаряемость. | API SL |
GF-2 | Устарела, была утверждена в 1997 году. | API SJ, SAE 0W-20, 5W-20 |
GF-1 | Устарела, была утверждена в 1996 году. | API SH, SAE 0W-XX, 5W-XX, 10W-XX, где ХХ 30,40, 50, 60 |
Как обозначается синтетика, полусинтетика, минеральное масло
Примерно 30% любого масла – это присадки, все остальное – основа, от которой во многом зависят характеристики масла, так же, как и от пакета присадок. По базе масла можно классифицировать на 3 группы: синтетика, полусинтетика и минеральное.
Минеральные масла обозначаются Mineral, имеют полностью минеральную основу, то есть изготавливаются из обработанной нефти. Эти масла самые бюджетные, но имеют показатели гораздо хуже, чем две другие категории. Самыми лучшими характеристиками обладает синтетика. Минеральное масло быстрее окисляется, имеет более высокую температуру замерзания и не так стабильно при высоких температурах. В процессе кипения масло оставляет налет на деталях.
Полусинтетические масла обозначаются Semi-Synthetic – произведено из смеси минеральной базы и синтезированной основы. Компромисс между дешевой и ненадежной минералкой и дорогой, но хорошей синтетикой. Сохраняет качества синтетического и минерального масла, повышаются технические характеристики и чистота деталей мотора, но все же не сравнима с чистой синтетикой.
Синтетические масла обозначаются Fully Synthetic – база получена в результате синтеза из природного газа или другим путем. В базу могут добавляться минеральные присадки, это никак не сказывается на качестве конечного продукта. Если автомобиль используется с большими нагрузками или в сильные морозы, ему подходит только такой продукт.
Синтетика делится на несколько категорий, в зависимости от метода ее производства, первый из них – гидрокрекинг, базу получают путем переработки натуральной нефти, ее глубокой очистки и гидрообработок. В результате сырье имеет такие же свойства, как синтетика, но себестоимость снижается. Масло очень популярно в последнее время, половина продуктов на полках имеют именно такую базу. Эти масла относят к синтетическим. По желанию производитель может маркировать такой продукт HC, а может не ставить метку.
Вторая категория – ПАО, особенность такой базы в том, что даже без специальных присадок имеет очень низкий порог замерзания – до -50оС. Производятся по достаточно сложной технологии: альфаолефиты проходят по нескольким этапам – олигомеризация, двойная дистилляция, гидрогенизация с использованием катализаторов. Получается база с однородным составом, показывающая низкую испаряемость, легкий холодный пуск, высокую вязкость, удлиненный срок использования, стабильность при высоких температурах и антиоксидантные свойства. Даже если база не на 100% состоит из ПАО, она имеет высокие технические характеристики.
Эстеры. Имеют самую высокую стоимость, производятся из эфиров растительной природы, в этом и заключается их уникальность. Другие группы масел изготавливают из переработанной нефти, эти же из растительной базы. Для изготовления используют технологию эрификации карбоновых кислот спиртами. Полярность молекул базы смещает электронную плотность к атому кислорода, который тянется к деталям мотора, за счет такой поляризации образуется очень плотная пленка.
Эстеры имеют высокие защитные свойства и высокие показатели стойкости к нагрузкам, обеспечивают легкий пуск в морозы и чистоту внутренних деталей, масло очень экологично и просто в утилизации. Смазки с эстерами попадаются в продаже не так часто ввиду своей высокой стоимости. Зачастую это не чистая база из эстеров, а только некоторая ее часть, повышающая технические характеристики готового продукта.
Классификация моторных масел API | oilday.ru
Классификация моторных масел API была создана в 1969 году Американским институтом топлива (American Petroleum Institute). Классификацию API называют классификацией по качеству моторных масел.
Данная классификация разделяет моторные масла на:
• масла для бензиновых двигателей;
• масла для дизельных двигателей;
• масла для двухтактных двигателей;
• трансмиссионные масла;
Для каждого из этих видов предусмотрены классы качества, которые описывают определенный набор свойств и качеств автомобильных масел каждого класса.
На этикетке информация о присвоении моторному маслу класса по системе API предоставлена в таком виде: API SM, API CF, или API SM/CF.
Если моторное масло можно применять в обоих типах двигателей, то такому маслу присваивается два класса – для дизельных и для бензиновых двигателей. На этикетке масла эти классы разделены косой чертой, например, API SJ/CF-4. При этом, первым ставится тот класс масла, который соответствует более предпочтительному (по мнению производителя автомасла) применению. То есть, в приведенном выше случае, основное предназначение автомасла – для бензиновых двигателей, но при этом производитель допускает его использование и в дизельных моторах.
Следует заметить, что отсутствие на этикетке моторного масла информации о соответствии какому-либо из классов API однозначно означает, что это автомасло либо вообще не имеет сертификата API, либо присвоенный ему класс качества устарел.
Что означают символы кода API?
Буквенно-циферный код – это обозначение класса масла.
При этом, первая буква кодировки означает вид масла:
«S» — для бензиновых двигателей (service / spark ignition)
«C» — для дизельных двигателей (commercial / compression ignition)
«T» — для двухтактных двигателей (two-stroke)
Классы качества моторного масла API: бензиновые двигатели
API SN
Новый класс SN создавался американским нефтяным институтом (API) совместно с американской профессиональной ассоциацией ASTM (Американское общество по испытанию материалов) и SAE (Общество инженеров автомобильной промышленности).
Отличия класса API SN от предыдущей спецификации SM гораздо более масштабны, нежели отличия класса SM от SL. Основное отличие API SN от предыдущих классификаций API в ограничении содержания фосфора для совместимости с современными системами нейтрализации выхлопных газов, а также комплексное энергосбережение. То есть, масла, классифицируемые по API SN, будут приблизительно соответствовать АСЕА С2, С3, С4, без поправки на высокотемпературную вязкость.
Для новой категории API SN Комитет по смазочным материалам предложил следовать той же схеме развития, что и с более ранними категориями API и ILSAC. Это означает, что все эксплуатационные характеристики моторных масел для API и ILSAC будут эквивалентны, кроме того, что предлагаемые требования API SN не включают в себя тесты на защиту от износа по методике Sequence IIIG на состаренных маслах. Эти тесты и испытания на экономию топлива по методике Sequence VID являются важными ориентирами для масел, претендующих на соответствие стандарту ILSAC GF–5.
Основные же отличия ILSAC GF–5 от предыдущей классификации GF4, в возможности работы с биотопливом, улучшенной защитой от износа и коррозии, большей топливной экономичности, улучшенной совместимостью с уплотнительными материалами и улучшенной защитой от шламообразования.
Требования API SN и ILSAC GF-5 достаточно близки и маловязкие масла, скорее всего, будут классифицироваться совместно по этим двум классификациям.
Масла, соответствующие API SN могут применяться для замены API SM и более ранних.
API SM
Моторные масла для бензиновых двигателей с 2004 года выпуска.
Класс утвержден 30 ноября 2004 года.
Класс API SM описывает моторные масла для современных бензиновых (многоклапанных, турбированных) двигателей. По сравнению с классом API SL, моторные масла, соответствующие требованиям API SM, должны обладать более высокими показателями защиты от окисления и преждевременного износа деталей двигателя. Кроме того, повышены стандарты относительно свойств масла при низких температурах. Моторные масла этого класса могут быть сертифицированы по классу энергосбережения ILSAC.
Требования категории API SM обусловлены современными тенденциями развития техники: экологичности, увеличению интервалов техобслуживания, неизменной надежности работы.
Моторные масла, соответствующие требованиям API SM могут применяться в случаях, когда производителем автомобиля рекомендуется класс API SL или более ранние.
API SL
Моторные масла для бензиновых двигателей с 2000 года выпуска.
В соответствии с требованиями производителей автомобилей, автомасла класса API SL применяются в многоклапанных, турбированных моторах, работающих на обеднённых смесях топлива, соответствующих современным повышенным требованиям по экологии, а также энергосбережению.
Моторные масла, соответствующие требованиям API SL могут использоваться в случаях, когда автопроизводителем рекомендуется класс API SJ или более ранние.
API SK
Из-за того, что один корейский производитель моторных масел использует сокращение «SK» в качестве своего корпоративного имени, для исключения возможной путаницы буква «К» не используется для обозначения категории моторных масел для бензиновых двигателей.
API SJ
Моторные масла для бензиновых двигателей с 1996 года выпуска.
Категория API SJ утверждена 6 ноября 1995 года, лицензии выдаются с 15 октября 1996 года.
Автомобильные масла этого класса предназначены для использования в бензиновых моторах легковых и спортивных машин, микроавтобусов и легких грузовых машин, которые обслуживаются в соответствии с требованиями производителей автомобилей. SJ предусматривает такие же минимальные стандарты, как и SH, а также дополнительные требования к нагарообразованию и работе при низких температурах. Масла попадают под сертификацию по категории энергосбережения API SJ/EC.
Моторные масла, удовлетворяющие требованиям API SJ, могут применяться в тех случаях, когда производителем автомобиля рекомендуется класс SH или более ранние.
API SH
Моторные масла для бензиновых двигателей с 1993 года выпуска.
Категория API SH утверждена в 1992 году, является условно действующей и может быть сертифицирована только как дополнительная к категориям для дизельных двигателей.
Моторные масла этого класса предназначены для использования в бензиновых моторах легковых машин, микроавтобусов и легких грузовых автомобилей 1996 года и старше, в соответствии с рекомендациями их производителей. Моторные масла данного класса тестировались в соответствии с требованиями Ассоциации производителей химической продукции (СМА).
Класс характеризуется более высокими требованиями по сравнению с классом SG, и был разработан, как заменитель последнего, для улучшения антинагарных, противоокислительных, антиизносных свойств масел и повышенной защиты от коррозии.
Класс API SH соответствует категории ILSAC GF-1 по всем параметрам, кроме обязательного энергосбережения и, в зависимости от степени экономии топлива, относится к категориям API SH/EC и API SH/ECII.
Моторные масла этого класса могут использоваться в тех случаях, когда производителем автомобиля рекомендуется класс API SG или более ранний.
API SG
Моторные масла для бензиновых двигателей с 1989 по 1993 годов выпуска.
Категория API SG утверждена в 1988 году, действие прекращено в конце 1995 года.
Предназначены для использования в бензиновых моторах легковых машин, микроавтобусов и легких грузовиков моделей 1993 года и старше, работающих на неэтилированном бензине с оксигенатами. Моторные масла этого класса обладают свойствами, обеспечивающими улучшенную защиту от нагара, окисления автомасла и износа мотора, в сравнении с предыдущими классами, а также содержат присадки, защищающие от ржавления и коррозии внутренних деталей двигателя.
Моторные масла класса API SG соответствуют требованиям к моторным маслам для дизельных моторов API CC и CD. Могут использоваться там, где рекомендуются классы API SF, SE, SF/CC или же SE/CC.
API SF
Моторные масла для бензиновых двигателей с 1980 по 1989 годов выпуска.
Эти моторные масла применялись в бензиновых моторах 1980-1989 годов выпуска, работающих на этилированном бензине, при условии наличия рекомендаций и инструкций производителя двигателя.
Обеспечивают усиленную устойчивость к окислению, ржавлению и коррозии, улучшенную защиту от износа деталей, в сравнении базовыми характеристиками автомасел класса API SE, а также более надежную защиту от нагара и шлака.
Моторные масла класса API SF могли применяться, как заменители предыдущих классов API SE, SD или SC.
API SE
Моторные масла для бензиновых двигателей с 1972 по 1980 годов выпуска.
Эти моторные масла применялись в бензиновых моторах моделей выпуска 1972-1979 годов, а также в некоторых моделях 1971 года.
Дополнительная защита в сравнении с автомаслами API SC и SD. Могут использоваться как заменители API SC и SD.
API SD
Моторные масла для бензиновых двигателей с 1968 по 1971 годов выпуска.
Автомасла этого класса использовались в бензиновых моторах легковых машин и некоторых грузовых выпуска 1968-70 годов, а также некоторых моделей 1971 года и позднее.
Улучшенная защита по сравнению с моторными маслами API SC, применялись также исключительно при наличии рекомендации производителя двигателя.
API SC
Моторные масла для бензиновых двигателей с 1964 по 1967 годов выпуска.
Обычно применялись в моторах легковых машин и некоторых грузовиков выпуска 1964-1967 годов. Уменьшают высоко- и низкотемпературный нагар, износ, а также защищают от коррозии.
API SB
Моторные масла для маломощных бензиновых моторов.
Моторные масла 30-х годов 20-го века, обеспечивавших достаточно легкую защиту от износа и окисления, а также антикоррозийную защиту подшипников в моторах, которые эксплуатируются в легких нагрузочных режимах.
Моторные масла класса API SB могут применяться только, если они специально рекомендованы производителем двигателя.
API SA
Моторные масла для бензиновых и дизельных моторов.
Устаревший класс масел для использования в старых моторах, работающих в таких условиях и режимах, при которых защита деталей с помощью присадок не нужна.
Моторные масла класса API SA могут применяться только, если они рекомендованы производителем двигателя.
Классы качества моторного масла API: дизельные двигатели
API СJ-4
Моторные масла для дизельных двигателей с 2006 года выпуска.
Классификация API СJ-4 лицензирована с октября 2006.
Класс API CJ-4 разработан для тяжелонагруженных дизельных двигателей, которые отвечает ключевым требованиям по нормам выбросов NOx и твердых частиц для двигателей 2007 года выпуска и рекомендован для двигателей, оборудованных сажевыми фильтрами, а также иными системами снижения токсичности выхлопных газов.
Стандарт API CJ-4 несет значительные изменения в ответ на потребности производителей новых двигателей, которые отвечают новым экологическим стандартам, которые вводятся с 2007 года. На масла API CJ-4 налагаются лимиты по некоторым показателям: зольность меньше чем 1,0 %, сера 0,4%, фосфор 0,12%.
Классификация API CJ-4 превышает требования более ранних категорий API CI-4 PLUS, CI-4 и может использоваться как их замена.
API CI-4 PLUS
Дополнительный эксплуатационный класс моторных масел API CI-4 PLUS для дизельных двигателей введён в 2004 году.
По сравнению с API CI-4 повышены требования к удельному содержанию сажи, а также испаряемости и высокотемпературному окислению. При сертификации в данной классификации моторное масло должно тестироваться в семнадцати моторных тестах.
API CI-4
Моторные масла для дизельных двигателей с 2002 года выпуска.
Класс API CI-4 введен в 2002 году.
Эти моторные масла применяются в современных дизельных двигателях с различными видами впрыска и наддува, а также в двигателях с системой рециркуляции отработанных газов (EGR).
Класс API CI-4 введен в связи с появлением новых, более жестких требований по экологии и токсичности выхлопных газов, которые предъявляются к двигателям, выпускаемым с 1 октября 2002 г. Ужесточены требования к сажеобразованию, отложениям, вязкостным показателям, ограничение значения TBN.
Моторное масло, соответствующее API CI-4, должно содержать соответствующие моюще-диспергирующие присадки и имеет, в сравнении с классом API CH-4, повышенную устойчивость к термическому окислению, а также более высокие диспергирующие свойства. Кроме того, такие автомасла обеспечивают существенное уменьшение угара моторного масла за счет снижения летучести и уменьшения испарения при рабочей температуре до 370°C, под воздействием газов. Ужесточены требования относительно холодной прокачиваемости, увеличен ресурс зазоров, допусков и уплотнений мотора за счет улучшения текучести автомасла.
Классификация API CI-4 заменяет масла API CD, СЕ, CF-4, CG 4 и СН-4.
API CH-4
Моторные масла для дизельных двигателей с 1998 года выпуска.
Класс API CH-4 был введен 1 декабря 1998 года.
Моторные масла данного класса применяются в четырехтактных дизельных двигателях, которые эксплуатируются в высокоскоростных режимах и соответствуют требованиям норм и стандартов по токсичности выхлопных газов, принятых в 1998 году.
Автомасла API CH-4 соответствуют достаточно жестким требованиям как американских, так и европейских производителей дизельных двигателей. Требования класса специально разработаны для использования в моторах, работающих на высококачественном топливе с удельным содержанием серы до 0,5%. При этом, в отличие от класса API CG-4, ресурс этих моторных масел менее чувствителен к использованию дизельного топлива с содержанием серы более 0,5%, что особенно актуально для стран Южной Америки, Азии, Африки.
Моторные масла API CH-4 соответствуют повышенным требованиям и должны содержать присадки, более эффективно предотвращающие износ клапанов и образование нагара на внутренних поверхностях.
Масла API GH-4 могут применяться, как заменители моторных масел API CD, CE, CF-4 и CG-4, в соответствии с рекомендациями производителя двигателя.
API CG-4
Моторные масла для дизельных двигателей с 1995 года выпуска.
Класс API CG-4 представлен в 1995 году.
Моторные масла этого класса рекомендуются для четырехтактных дизельных двигателей автобусов, грузовых машин и тягачей магистрального и немагистрального типа, которые эксплуатируются в режимах повышенных нагрузок, а также высокоскоростных режимах.
Моторное масло API CG-4 подходит для двигателей, в которых используется высококачественное топливо с удельным содержанием серы не более 0,05%, а также в моторах, для которых не выдвигается особых требований к качеству топлива (удельное содержание серы может достигать 0,5%).
Автомасла, сертифицированные по классу API CG-4, должны более эффективно предотвращать износ внутренних деталей двигателя, образование нагара на внутренних поверхностях и поршнях, окисление, пенообразование, образование сажи (эти свойства особенно нужны для двигателей современных магистральных автобусов и тягачей).
Класс API CG-4 создан в связи с утверждением в США новых требований и стандартов по экологии и токсичности выхлопных газов (редакция 1994 года). Основной недостаток, ограничивающий массовое использование автомасел данного класса, например в восточной Европе и Азии, это существенная зависимость ресурса автомасла от качества используемого топлива.
Моторные масла API CG-4 могут применяться в двигателях, для которых рекомендуются классы API CD, CE и CF-4.
API CF (CF-2, CF-4)
Моторные масла для дизельных двигателей с непрямым впрыском.
Цифра через дефис означает двух- или четырехтактный двигатель.
Класс API CF описывает моторные масла рекомендованные к применению в дизельных двигателях с непрямым впрыском, а также других видах дизельных двигателей, которые работают на топливе различного качества, в том числе и с повышенным содержанием серы (например, больше 0,5% от общей массы).
Моторные масла, сертифицированные по классу API CF, содержат присадки, способствующие более эффективному предотвращению отложений на поршне, износа и коррозии медных (с содержанием меди) подшипников, что имеет большое значение для двигателей этих видов, и могут прокачиваться обычным способом, а также с помощью турбонагнетателя или компрессора.
Моторные масла API CF могут использоваться там, где рекомендуется класс качества API CD.
API CF-2 (CF-II)
Моторные масла для дизельных двигателей с 1994 года выпуска.
Класс API CF-2 введен в 1994 году.
Моторные масла этого класса обычно используются в двухтактных дизельных двигателях, которые работают в условиях повышенной нагруженности. Масла API CF-2 должны содержать присадки, которые обеспечивают защиту повышенной эффективности от износа внутренних деталей двигателя, например цилиндров и колец. Кроме того, эти автомасла должны предотвращать накопление отложений на внутренних поверхностях мотора, то есть, для данных масел характерна улучшенная функция очистки.
Моторное масло, сертифицированное по классу API CF-2, обладает улучшенными свойствами и может использоваться вместо более ранних аналогичных масел, при наличии рекомендации производителя.
API CF-4
Моторные масла для дизельных двигателей с 1990 года выпуска.
Класс API CF-4 введен в 1990 году.
Моторные масла данного класса могут использоваться в четырехтактных дизельных двигателях, условия эксплуатации которых связаны с высокоскоростными режимами.
Автомасла API CF-4 должны содержать соответствующие присадки, которые обеспечивают снижение угара автомасла, а также защиту от нагара в поршневой группе. Основное предназначение моторных масел данного класса – применение в дизельных двигателях сверхмощных тягачей и других автомобилей, которые используются для дальних поездок по автомагистралям.
Кроме того, таким моторным маслам иногда присваивается сдвоенный класс API CF-4/S. В таком случае, при условии наличия соответствующих рекомендаций производителя двигателя, эти автомасла могут применяться и в бензиновых двигателях.
Требования к качеству масел API CF-4 превышают возможности предыдущего класса API СЕ, поэтому моторные масла API CF-4 могут использоваться вместо масел класса API СЕ, при наличии соответствующих рекомендаций производителя двигателя.
API СЕ
Моторные масла для дизельных двигателей с 1983 года выпуска.
Автомасла класса API CE предназначались для использования в некоторых сверхмощных турбированных моторах, характеризующихся существенно повышенной рабочей компрессией. Применение таких масел допускалось для двигателей как с низкой, так и с высокой частотой вращения вала.
Моторные масла API СЕ рекомендовались для низко- и высокооборотистых дизельных двигателей, выпущенных, начиная с 1983 года, которые эксплуатировались в режимах повышенной нагрузки. При условии наличия соответствующих рекомендаций производителя двигателя, эти автомасла могли быть использованы также в моторах, для которых рекомендовались моторные масла класса API CD.
API CD-II (CD-2)
Моторные масла для двухтактных дизельных двигателей с 1985 года выпуска.
Класс API CD-II введен в 1985 году для использования в двухтактных дизельных моторах и является, по сути, эволюционным развитием предыдущего класса API CD. Основным предназначением использования таких автомасел являлось применение в тяжелых мощных дизельных двигателях, которые устанавливались, в основном на сельскохозяйственную технику.
Моторные масла этого класса соответствуют всем рабочим стандартам предыдущего класса API CD, кроме этого существенно повышены требования относительно высокоэффективной защиты двигателя от нагара и износа.
API CD+
Моторные масла для дизельных двигателей японского производства.
Дополнительная категория API CD+ учитывает возросшие требования к качеству моторных масел для японских дизельных двигателей.
Масла обладают высокой устойчивостью к окислению и загущению под влиянием накопления сажи, а также повышенной защитой от износа узла клапанов.
API CD
Моторные масла для дизельных двигателей с 1955 года выпуска.
Класс API CD введен в 1955 году для обычного использования в некоторых дизельных моторах, как атмосферных, так и турбированных, с увеличенной компрессией в цилиндрах, где крайне важна эффективная защита от нагара и износа. Моторные масла этого класса обычно использовались в сельскохозяйственной технике.
Моторные масла API CD могли использоваться в случаях, когда производителем двигателя не выдвигались дополнительные требования к качеству топлива (включая топливо с повышенным содержанием серы).
Автомасла API CD должны были, по сравнению с предыдущими классами, обеспечивать повышенную защиту от коррозии подшипников и высокотемпературного нагара в дизельных моторах. Нередко моторные масла этого класса называли «Caterpillar серия 3», благодаря тому, что они соответствовали требованиям сертификации Superior Lubricants (Series 3), разработанной тракторной компанией Катерпиллар.
API СС
Моторные масла для дизельных двигателей с 1961 года выпуска.
Класс API CC введен в 1961 году для использования в некоторых моторах, как атмосферных, так и турбированных, которые характеризовались повышенной компрессией. Моторные масла этого класса рекомендовались для двигателей, которые эксплуатировались в режимах умеренной и высокой нагрузки.
Кроме того, при условии наличия рекомендаций производителя двигателя, такие автомасла могли использоваться в некоторых мощных бензиновых моторах.
По сравнению с более ранними классами, моторные масла API СС должны были обеспечивать более высокий уровень защиты от высокотемпературного нагара и коррозии подшипников в дизельных моторах, а также от ржавления, коррозии и низкотемпературного нагара в бензиновых моторах.
API СВ
Моторные масла для дизельных двигателей с 1949 по 1960 годов выпуска.
Моторные масла для дизельных двигателей, работающих со средней нагрузкой на сернистом топливе.
Класс утвержден в 1949 году как эволюционное развитие класса API СА, при использовании топлива с повышенным содержанием серы, без особых требований к качеству. Автомасла API СВ предназначались также для использования в моторах с наддувом, которые эксплуатировались в легком и умеренном режимах. Часто этот класс называли «Моторные масла «Приложение 1», тем самым, подчеркивая соответствие военному предписанию MIL-L-2104A Приложение 1.
API СА
Моторные масла для дизельных двигателей с 1940 по 1950 годов выпуска.
Моторные масла для малонагруженных дизельных двигателей.
Автомасла этого класса предназначены для использования в дизельных моторах, работающих в легких и умеренных режимах на качественном малосернистом дизельном топливе.
В соответствии с рекомендациями производителей автомобилей, могут применяться и в некоторых бензиновых моторах, которые эксплуатируются в умеренных режимах.
Класс широко использовался в 40-х и 50-х годах прошлого века и не может использоваться в современных условиях, если это не предусмотрено требованиями производителя двигателя.
Моторные масла API СА должны обладать свойствами, обеспечивающими защиту от нагара на поршневых кольцах, а также от коррозии подшипников в моторах с наддувом, для которых не предусмотрены особые требования к качеству топлива, которое используется.
Классы качества моторного масла API: двухтактные двигатели
API TD
Масла для подвесных двухтактных двигателей моторных лодок.
API TC
Масла для двигателей с высокими требованиями к качеству масла, кроме моторных лодок, например, двигатели мотоциклов, снегоходов. Возможно использование API TC в случаях, когда требуется класс API TA или TB.
API TB
Масла для скоростных двухтактных двигателей с объемом 50-200 см3, работающих под большими нагрузками, например, мотороллеры, бензопилы, мотоциклы.
API TА
Масла для двухтактных двигателей с объемом до 50 см3 с воздушным охлаждением, к примеру, мопеды, газонокосилки.
Классы качества моторного масла API: трансмиссионные масла
API GL-6
Трансмиссионные масла для гипоидных передач с увеличенным смещением, работающих в условиях высоких скоростей, больших крутящих моментов и ударных нагрузок.
Масла содержат большее количество серо-фосфорсодержащей противозадирной присадки, чем масла GL-5.
API GL-5
Трансмиссионные масла для гипоидных передач с уровнем эксплуатационных свойств MIL-L-2105 C/D. Эти масла предпочтительно применяются в передачах с гипоидными коническими зубчатыми колесами и коническими колесами с круговыми зубьями для главной передачи в автомобилях, в карданных приводах мотоциклов и ступенчатых коробках передач мотоциклов.
Масла применяются специально для гипоидных передач с высоким смешением оси. Для самых тяжелых условий эксплуатации с ударной и знакопеременной нагрузкой. Рекомендовано для гипоидных передач, работающих в условиях высоких скоростей при малых крутящих моментах и ударных нагрузках на зубья шестерен.
Масла содержат большое количество серо-фосфорсодержащей противозадирной присадки.
API GL-4
Трансмиссионные масла с высоким содержанием присадок с уровнем эксплуатационных свойств MIL-L-2105. Эти масла применяются предпочтительно в ступенчатых коробках передач и рулевых механизмах, в главных передачах и гипоидных передачах с малым смещением в автомобилях и безрельсовых транспортных средствах для перевозки грузов и пассажиров и для нетранспортных работ.
Масла применяются для гипоидных передач, работающих в условиях высоких скоростей при малых крутящих моментах и в условиях малых скоростей при больших крутящих моментах.
Обязательно наличие высокоэффективных противозадирных присадок.
API GL-3
Трансмиссионные масла с высоким содержанием присадок с уровнем эксплуатационных свойств MIL-L-2105. Эти масла применяются предпочтительно в ступенчатых коробках передач и рулевых механизмах, в главных передачах и гипоидных передачах с малым смещением в автомобилях и безрельсовых транспортных средствах для перевозки грузов, пассажиров и для нетранспортных работ.
Масла применяются для спирально-конических передач, работающих в умеренно жестких условиях, а также для обычных трансмиссий со спирально-коническими шестернями, работающих в умеренно жестких условиях по скоростям и нагрузкам.
Обладают лучшими противоизносными свойствами, чем API GL-2.
API GL-2
Трансмиссионные масла для червячных передач, работающих в условиях GL-1 при низких скоростях и нагрузках, но с более высокими требованиями к антифрикционным свойствам.
Могут содержать антифрикционный компонент.
API GL-1
Минеральные масла без присадок либо масла с антиокислительными и противопенными присадками, но без противозадирных компонентов для применения в коробках передач с ручным управлением с низкими удельными давлениями и скоростями скольжения.
Масла применяются в цилиндрических, червячных и спирально-конических зубчатых передачах, работающих при низких скоростях и нагрузках.
API МТ-1
Масла для высоконагруженных агрегатов.
Предназначены для несинхронизированных механических коробок передач мощных коммерческих автомобилей (тягачей и автобусов).
Эквивалентны маслам API GL-5, но обладают повышенной термической стабильностью.
API PG-2
Масла для передач ведущих мостов мощных коммерческих автомобилей (тягачей и автобусов) и мобильной техники.
Эквивалентны маслам API GL-5, но обладают повышенной термической стабильностью и улучшенной совместимостью с эластомерами.
Классификация SAE
Классификация ACEA
Классификация ILSAC
Классификация JASO
Классификация моторных масел по API
Наибольшую популярность среди автомобилистов получила классификация эксплуатационных свойств масел по API (American Petroleum Institute).
По системе API (ASTM D 4485, SAE J183 APR96) установлены три эксплуатационные категории (три ряда) назначения и качества моторных масел:
S (Service) — состоит из категорий качества моторных масел для бензиновых двигателей, идущих в хронологическом порядке. Для каждого нового поколения масла присваивается дополнительная буква по алфавиту: API SA, SB, SC, SD, SE, SF, SG, SH, SJ, SL, SM, SN (категория SI — намеренно пропущена API, для исключения путаницы с Международной системой мер, для проекта категории PS-06 планировалось название SK, но один из поставщиков моторных масел в Корее использует сокращение «SK» как часть своего корпоративного имени. Для исключения возможной путаницы буква «К» была заменена следующей «L». Категории API SA, API SB, API SC, API SD, API SE, API SF, API SG на сегодняшний день признаны недействительными, как устаревшие, однако в некоторых странах масла этих категорий еще выпускаются.
C (Commercial) — состоит из категорий качества и назначения масел для дизельных двигателей, идущих в хронологическом порядке. Для каждой новой генерации присваивается дополнительная буква по алфавиту: API СA, СB, СC, СD, CE, CF, CF-2, CF-4, CG-4, CH-4, CI-4, CJ-4. Категории API СA, API СB, API СC, API СD, API СD-II на сегодняшний день признаны недействительными, как устаревшие, однако в некоторых странах масла этих категорий еще выпускаются.
EC (Energy Conserving) — энергосберегающие масла — новый ряд высококачественных масел, состоящий из маловязких масел, уменьшающих расход топлива по результатам тестов на бензиновых двигателях. Моторные масла, отличающиеся низкой вязкостью как при низкой, так и при высокой температуре могут быть сертифицированы на соответствие категории API EC «энергосберегающее» масло («Energy Conserving» Oil).
Универсальные масла для бензиновых и для дизельных двигателей обозначаются двумя символами соответствующих категорий: первый символ является основным, а второй указывает на возможность применения этого масла для двигателя другого типа. Например, API CG-4/SH — масло, оптимизированное для применения в дизельных двигателях, но его можно применять и в бензиновых двигателях, для которых предписывается масло категории API SH и ниже (SG, SF, SE и т.д.).
API — для бензиновых двигателей | ||
---|---|---|
SN | Введена 1 октября 2010 г. Предназначена для масел, эксплуатируемых в самых современных бензиновых двигателях пассажирских и спортивных автомобилей и небольших фургонов. Масла этой категории обладают улучшенными антиокислительными и моющими свойствами, обеспечивает высокую защиту от износа и коррозии. Усилены высокотемпературные свойства для эксплуатации в двигателях с турбонаддувом. Могут использоваться там, где рекомендуется применение масел категории SM и SL. Некоторые масла из этой категории могут соответствовать спецификации ILSAC GF-5 и квалифицироваться как энергосберегающие | |
SM | Для двигателей 2010 г и раньше. В дополнении к категории SL улучшены антиокислительные и противоизносные свойства. Масла этой категории отличаются сохранением низкотемпературных свойств даже после длительных интервалов эксплуатации. Некоторые из этих масел могут также соответствовать спецификации ILSAC GF-4 и/или быть энергосберегающими (Energy Conserving) | |
SL | Для двигателей 2004 года или раньше. Отличаются стабильностью энергосберегающих свойств, пониженной летучестью, удлиненными интервалами замены. API планировал разрабатывать проект PS-06 как следующую категорию API SK, но один из поставщиков моторных масел в Корее использует сокращение «SK» как часть своего корпоративного имени. Для исключения возможной путаницы буква «К» пропускается для следующей категории «S» | |
SJ | Для двигателей 2001 года или раньше. Масла для бензиновых двигателей, отвечающие высоким требованиям в отношении расхода масла в двигателе, энергосберегающих свойств (экономии топлива) и способности выдержи¬вать нагрев, не образуя отложений. Могут применяться в тех случаях, когда рекомендованы масла уровня SH и более ранних | |
SH | Для двигателей до 1996 года или раньше. По требованиям соответствует категории ILSAC GF-1, но без обязательного энергосбережения. Масла данной категории предназначены для бензиновых двигателей моделей 1996 года и старше. При проведении сертификации на энергосбережение, в зависимости от степени экономии топлива присваивались категории API SH/EC и API SH/ECII |
API — для дизельных двигателей | ||
---|---|---|
CJ-4 | Введена в 2006. Для быстроходных четырёхтактных двигателей, проектируемых для удовлетворения норм по токсичности отработавших газов 2007 года на магистральных дорогах. Масла CJ-4 допускают использование топлива с содержанием серы вплоть до 500 ppm (0,05% от массы). Масла CJ-4 рекомендованы для двигателей, оборудованных дизельными сажевыми фильтрами и другими системами обработки выхлопных газов. Масла со спецификацией CJ-4 превышают рабочие свойства CI-4, CH-4, CG-4, CF-4 и могут применяться в двигателях, которым рекомендуются масла этих классов | |
CI-4 | Введена в 2002. Для высокоскоростных 4-тактных двигателей разработанных в соответствии с требованиями стандарта 2002 года по эмиссии выхлопных газов. Для двигателей с рециркуляцией выхлопных газов (EGR). Для использования с топливами с | |
CH-4 | Категория представлена 1 декабря 1998 года. Масла данной категории предназначены для высокоскоростных, четырехтактных двигателей выполняющих требования жестких стандартов 1998 года по токсичности отработанных газов. Отвечают высочайшим требованиям не только американских, но и европейских производителей дизельных двигателей. Специально сформулированы для применения в двигателях, использующих топливо с содержанием серы до 0,5% от массы. В отличие от категории API CG-4, допускается применение дизельного топлива с содержанием серы более 0,5%, что является важным преимуществом в странах, в которых распространены высокосернистые топлива (Южная Америка, Азия, Африка). Масла удовлетворяют повышенным требованиям по уменьшению износа клапанов и уменьшению образования нагара. Заменяют масла категорий API CD, API CE, API CF-4 и API CG-4 |
API — для двухтактных двигателей | ||
---|---|---|
TA | Двухтактные двигатели мопедов, газонокосилок и соответствующих машин | |
TB | Маломощные мотоциклы, мотороллеры | |
TC | Смазка для двухтактных двигателей, работающих на суше, также тогда, когда требуется класс API-TA и API-TB | |
TD | Смазка для двухтактных подвесных лодочных моторов |
Таблицы данных — Ядро | | Выполнение действия выбора jQuery для всей таблицы. |
Таблицы данных — Ядро | | Пространство имен для методов Ajax |
Таблицы данных — Ядро | | Получить последние данные JSON, полученные из последнего запроса Ajax. DataTables сделал |
DataTables — Core | | Получить данные, отправленные DataTables на сервер в последнем запросе Ajax |
Таблицы данных — Ядро | | Перезагрузить данные таблицы из источника данных Ajax |
Таблицы данных — Ядро | | Получить / установить URL-адрес, который DataTables использует для выборки данных Ajax |
DataTables — Core | | Загрузить данные из вновь установленного URL источника данных |
Таблицы данных — Ядро | | Очистить таблицу от всех данных. |
Таблицы данных — Ядро | | Получить данные для всей таблицы. |
Таблицы данных — Ядро | | Уничтожить таблицы данных в текущем контексте. |
Таблицы данных — Ядро | | Перерисуйте таблицу. |
Таблицы данных — Ядро | | Поиск токена интернационализации. |
Таблицы данных — Ядро | | Получить параметры инициализации, используемые для таблицы. |
Таблицы данных — Ядро | | Удаление событий таблицы. |
Таблицы данных — Ядро | | Приемник событий таблицы. |
Таблицы данных — Ядро | | Прослушайте событие таблицы один раз, а затем удалите его. |
Таблицы данных — Ядро | | Получить / установить порядок, примененный к таблице. |
Таблицы данных — Ядро | | Получить / установить фиксированный порядок, примененный к таблице. |
DataTables — Core | | Добавить слушателя упорядочивания к элементу для заданного столбца. |
Таблицы данных — Ядро | | Получить / установить текущую страницу таблицы. |
Таблицы данных — Ядро | | Получить пейджинговую информацию о таблице |
Таблицы данных — Ядро | | Получить / установить длину страницы таблицы. |
Таблицы данных — Ядро | | Поиск данных в таблице. |
Таблицы данных — Ядро | | Получить объект настройки таблицы |
Таблицы данных — Ядро | | Получить последнее сохраненное состояние таблицы |
Таблицы данных — Ядро | | Очистить сохраненное состояние таблицы. |
DataTables — Core | | Получить состояние таблицы, загруженной во время инициализации. |
Таблицы данных — Ядро | | Запуск сохранения состояния. |
Таблицы данных — Ячейки | | Выберите одну ячейку в таблице. |
DataTables — Cells | | Получить кэшированные данные DataTables для выбранной ячейки |
DataTables — Cells | | Получить / установить данные для выбранной ячейки |
DataTables — Cells | | Получить индексную информацию о выбранной ячейке |
DataTables — Cells | | Сделать недействительными данные, содержащиеся в DataTables для выбранных ячеек |
DataTables — Cells | | Получить элемент DOM для выбранной ячейки |
DataTables — Cells | | Получить обработанные данные для ячейки |
Таблицы данных — Ячейки | | Выберите несколько ячеек в таблице. |
Таблицы данных — Ячейки | | Получить кэшированные данные DataTables для выбранных ячеек |
Таблицы данных — Ячейки | | Получить данные для выбранных ячеек |
Таблицы данных — Ячейки | | Итерация по каждой выбранной ячейке с заданным контекстом функции соответствующей ячейкой. |
Таблицы данных — Ячейки | | Получить индексную информацию о выбранных ячейках |
Таблицы данных — Ячейки | | Сделать недействительными данные, содержащиеся в DataTables для выбранных ячеек |
Таблицы данных — Ячейки | | Получить элементы DOM для выбранных ячеек |
Таблицы данных — Ячейки | | Получить обработанные данные для набора ячеек |
Таблицы данных — столбцы | | Выберите один столбец в таблице. |
Таблицы данных — столбцы | | Получить кэшированные данные DataTables для выбранного столбца. |
Таблицы данных — столбцы | | Получить данные для ячеек в выбранном столбце. |
Таблицы данных — столбцы | | Получить свойство источника данных для выбранного столбца. |
Таблицы данных — столбцы | | Получить узел нижнего колонтитула для выбранного столбца. |
Таблицы данных — столбцы | | Получить узел заголовка для выбранного столбца. |
Таблицы данных — столбцы | | Получить индекс выбранного столбца. |
Таблицы данных — столбцы | | Получить узлы ячеек для выбранного столбца. |
Таблицы данных — столбцы | | Упорядочить таблицу по выбранному столбцу. |
Таблицы данных — столбцы | | Поиск данных в выбранном столбце. |
Таблицы данных — столбцы | | Получить / установить видимость одного выбранного столбца. |
Таблицы данных — столбцы | | Преобразование между форматами индекса столбца |
Таблицы данных — столбцы | | Выберите несколько столбцов в таблице. |
Таблицы данных — столбцы | | Получить кэшированные данные DataTables для выбранных столбцов. |
Таблицы данных — столбцы | | Получить данные для ячеек в выбранных столбцах. |
Таблицы данных — Столбцы | | Получить свойство источника данных для выбранных столбцов. |
Таблицы данных — столбцы | | Итерация по каждому выбранному столбцу с заданным контекстом функции для рассматриваемого столбца. |
Таблицы данных — столбцы | | Получить узлы нижнего колонтитула для выбранных столбцов. |
DataTables — Columns | | Получить узел заголовка для выбранных столбцов. |
Таблицы данных — Столбцы | | Получить индексы выбранных столбцов. |
Таблицы данных — столбцы | | Получить узлы ячеек для выбранных столбцов. |
Таблицы данных — столбцы | | Упорядочить таблицу по выбранным столбцам. |
Таблицы данных — Столбцы | | Поиск данных в выбранных столбцах. |
Таблицы данных — столбцы | | Получить / установить видимость выбранных столбцов. |
Таблицы данных — столбцы | | Пересчитать ширину столбцов |
Таблицы данных — строки | | Выберите одну строку из таблицы. |
DataTables — Rows | | Получить кэшированные данные DataTables для выбранной строки. |
DataTables — Rows | | Пространство имен дочернего метода строки |
DataTables — Rows | | Получить / установить дочерние строки выбранной строки основной таблицы |
DataTables — Rows | | Скрыть дочерние строки после создания новых дочерних строк |
DataTables — Rows | | Удалить дочерние строки для выбранной родительской строки |
DataTables — Rows | | Сделать видимыми вновь определенные дочерние строки |
DataTables — Rows | | Скрыть дочернюю строку (строки) родительской строки |
DataTables — Rows | | Проверить, видны ли дочерние строки родительской строки |
DataTables — Rows | | Удалить дочерние строки для выбранной родительской строки |
DataTables — Rows | | Сделать дочернюю строку (и) родительской строки видимой |
DataTables — Rows | | Получить / установить данные для выбранной строки. |
DataTables — Rows | | Получить идентификатор выбранной строки. |
DataTables — Rows | | Получить индекс выбранной строки. |
DataTables — Rows | | Сделать недействительными данные, содержащиеся в DataTables для выбранной строки |
DataTables — Rows | | Получить узел строки |
DataTables — Rows | | Удалить выбранную строку из DataTable. |
Таблицы данных — строки | | Добавить новую строку в таблицу. |
Таблицы данных — строки | | Выберите несколько строк в таблице. |
Таблицы данных — строки | | Получить кэшированные данные DataTables для выбранных строк. |
DataTables — Rows | | Получить данные для выбранных строк. |
Таблицы данных — строки | | Итерировать по каждой выбранной строке с заданным контекстом функции соответствующей строкой. |
Таблицы данных — строки | | Получить идентификаторы выбранных строк. |
Таблицы данных — Строки | | Получить индексы выбранных строк. |
Таблицы данных — Строки | | Сделать недействительными данные, содержащиеся в DataTables для выбранных строк |
Таблицы данных — строки | | Получить строку |
Таблицы данных — Строки | | Удалить выбранные строки из DataTable. |
DataTables — Rows | | Добавить несколько новых строк в таблицу. |
Таблицы данных — Таблицы | | Выбрать таблицу на основе селектора из контекста API |
DataTables — Таблицы | | Получить узел |
Таблицы данных — Таблицы | | Получить узел контейнера |
Таблицы данных — Таблицы | | Получить узел |
DataTables — Таблицы | | Получить узел |
Таблицы данных — Таблицы | | Получить узел таблицы |
Таблицы данных — Таблицы | | Выбрать таблицы на основе селектора из контекста API |
Таблицы данных — Таблицы | | Получить узлы |
Таблицы данных — Таблицы | | Получить узлы контейнера |
Таблицы данных — Таблицы | | Получить узлы |
Таблицы данных — Таблицы | | Получить узлы |
Таблицы данных — Таблицы | | Получить узлы таблицы |
DataTables — Utility | | Определить, есть ли какие-либо записи в наборе результатов |
DataTables — Утилита | | Объедините несколько экземпляров API, чтобы создать один новый экземпляр. |
Таблицы данных — Утилита | | Получить количество элементов, содержащихся в экземпляре API |
Таблицы данных — Утилиты | | Перебирать содержимое набора результатов API. |
DataTables — Utility | | Сократите экземпляр Api до одного контекста и набора результатов. |
Таблицы данных — Утилита | | Создайте новый экземпляр API со всеми элементами из набора результатов, которые проходят данный тест. |
Таблицы данных — Утилита | | Преобразование экземпляра API со структурой 2D-массива в структуру 1D-массива. |
DataTables — Утилита | | Найдите первый экземпляр значения в наборе результатов экземпляра API. |
DataTables — Утилита | | Итерация по результирующему набору индексов таблицы, строки, столбца или ячейки |
DataTables — Утилита | | Объедините элементы в наборе результатов в строку. |
DataTables — Утилита | | Найдите последний экземпляр значения в наборе результатов экземпляра API. |
Таблицы данных — Утилита | | Количество элементов в наборе результатов экземпляра API. |
Таблицы данных — Утилита | | Создайте новый экземпляр API с набором результатов, определенным значениями, возвращаемыми функцией обратного вызова. |
Таблицы данных — Утилита | | Создайте новый экземпляр API со значением свойства из объектов в текущем наборе результатов. |
Таблицы данных — Утилиты | | Удалить последний элемент из набора результатов экземпляра API. |
DataTables — Утилита | | Добавьте один или несколько элементов в конец набора результатов экземпляра API. |
DataTables — Утилита | | Примените функцию обратного вызова к аккумулятору и каждому элементу в наборе результатов Api (слева направо). |
DataTables — Утилита | | Примените функцию обратного вызова к аккумулятору и каждому элементу в наборе результатов Api (справа налево). |
Таблицы данных — Утилита | | Обратный набор результатов экземпляра API. |
Таблицы данных — Утилиты | | Удалить первый элемент из набора результатов экземпляра API. |
Таблицы данных — Утилита | | Создайте независимую копию экземпляра API. |
DataTables — Утилита | | Сортировка элементов набора результатов экземпляра API. |
DataTables — Utility | | Измените содержимое набора результатов экземпляра Api, добавляя или удаляя элементы по мере необходимости. |
DataTables — Утилиты | | Преобразуйте экземпляр API в объект jQuery с объектами из набора результатов экземпляра в наборе результатов jQuery. |
DataTables — Утилита | | Создайте собственный объект массива Javascript из экземпляра API. |
DataTables — Утилита | | Преобразуйте экземпляр API в объект jQuery с объектами из набора результатов экземпляра в наборе результатов jQuery. |
Таблицы данных — Утилита | | Создайте новый экземпляр API, содержащий только уникальные элементы из элементов в наборе результатов экземпляра. |
DataTables — Utility | | Добавьте один или несколько элементов в начало набора результатов экземпляра API. |
Таблицы данных — статические | | Проверить, является ли узел таблицы DataTable или нет |
DataTables — статический | | Получить все таблицы данных на странице |
Таблицы данных — статические | | Экранировать специальные символы в строке регулярного выражения |
Таблицы данных — статические | | Регулировка вызовов метода для уменьшения частоты вызовов |
DataTables — статический | | Функция проверки совместимости номера версии |
AutoFill | | Отключить взаимодействие автозаполнения |
Автозаполнение | | Включение или отключение взаимодействия автозаполнения |
Автозаполнение | | Определить, включено ли автозаполнение |
Кнопки | | Сохранить файл, созданный на стороне клиента |
Кнопки | | Выберите одну кнопку |
Кнопки | | Получить / установить функцию действия для выбранной кнопки |
Кнопки | | Получить / установить активное состояние выбранной кнопки |
Кнопки | | Создайте новую кнопку и добавьте ее в документ |
Кнопки | | Отключить выбранную кнопку |
Кнопки | | Включение / отключение выбранной кнопки |
Кнопки | | Получить узел кнопки для выбранной кнопки |
Кнопки | | Показать всплывающее окно для кнопки, позволяющее вводить дополнительный пользовательский ввод |
Кнопки | | Получить / установить состояние обработки для кнопки |
Кнопки | | Удалить и удалить выбранную кнопку |
Кнопки | | Получить / установить текст для выбранной кнопки |
Кнопки | | Запуск действия выбранной кнопки |
Кнопки | | Выберите одну или несколько кнопок |
Кнопки | | Получить / установить функции действий для выбранных кнопок |
Кнопки | | Установить активное состояние для выбранных кнопок |
Кнопки | | Получить элемент контейнера для одного экземпляра Buttons |
Кнопки | | Получить элементы контейнера для одного или нескольких экземпляров кнопки |
Кнопки | | Уничтожить один или несколько экземпляров кнопки и удалить из документа |
Кнопки | | Отключить выбранные кнопки |
Кнопки | | Включение / отключение выбранных кнопок |
Кнопки | | Получить узлы кнопок для выбранных кнопок |
Кнопки | | Установить состояние обработки для нескольких кнопок |
Кнопки | | Удалить и удалить выбранные кнопки |
Кнопки | | Получить / установить текст для выбранных кнопок |
Кнопки | | Запуск действия выбранных кнопок |
Кнопки | | Получить данные из DataTable, которые подходят для экспорта |
Кнопки | | Получение метаинформации об экспорте, которая является общей для многих различных типов кнопок |
Кнопки | | Отображение и скрытие информации для конечного пользователя в модальном окне |
Кнопки | | Изменение размера всех кнопок Flash после того, как таблица стала видимой |
ColReorder | | Отключить взаимодействие ColReorder |
ColReorder | | Включение или отключение взаимодействия ColReorder |
ColReorder | | Программное перемещение столбцов |
ColReorder | | Получить / установить порядок столбцов |
ColReorder | | Восстановить порядок загруженных столбцов |
ColReorder | | Преобразование одного или нескольких индексов столбцов в текущий и исходный индексы и обратно |
FixedColumns | | Получить узел ячейки с фиксированным столбцом для ячейки |
FixedColumns | | Получить узлы ячеек с фиксированным столбцом для нескольких ячеек |
FixedColumns | | Пространство имен для методов FixedColumns |
FixedColumns | | Получить индекс ячейки в фиксированном столбце |
FixedColumns | | Перерисовать фиксированные столбцы в соответствии с новым размером таблицы |
FixedColumns | | Получить индекс строки в фиксированном столбце |
FixedColumns | | Обновление данных, отображаемых в FixedColumns |
FixedColumns | | Пересчитать высоту одной или нескольких строк после изменения данных |
FixedHeader | | Пересчитать положение таблицы и перерисовать фиксированные элементы |
FixedHeader | | Отключить неподвижные элементы |
FixedHeader | | Включение / отключение фиксированных элементов |
FixedHeader | | Получить текущий включенный статус |
FixedHeader | | Получить / установить смещение фиксированного нижнего колонтитула |
FixedHeader | | Получить / установить фиксированное смещение заголовка |
KeyTable | | Фокус на ячейке |
KeyTable | | Размытие в фокусе из таблицы |
KeyTable | | Отключить взаимодействие KeyTable (мышь и клавиатура) |
KeyTable | | Включение или отключение взаимодействия KeyTable (мышь и клавиатура) |
KeyTable | | Определить состояние включения KeyTable для таблицы |
KeyTable | | Переместить фокус на соседнюю ячейку |
Адаптивный | | Получить состояние видимости столбца в таблице |
Адаптивный | | Получить состояние видимости столбцов в таблице |
Адаптивный | | Определить, не скрыл ли Responsive какие-либо столбцы в таблице |
Адаптивный | | Получить индекс ячейки из элемента сведений |
Адаптивный | | Пересчитать контрольные точки столбца на основе информации о классе ячеек заголовка столбца |
Адаптивный | | Пересчитать ширину, используемую отзывчивым, после изменения дисплея |
RowGroup | | Получить / установить источник данных для группы строк |
RowGroup | | Отключить взаимодействие RowGroup с таблицей |
RowGroup | | Включение или отключение взаимодействия RowGroup с таблицей |
RowGroup | | Определить, включена ли RowGroup для таблицы |
RowReorder | | Отключить возможность пользователя изменять порядок строк. |
RowReorder | | Включение / отключение возможности пользователя изменять порядок строк. |
Скроллер | | Прокрутка до определенной строки |
Скроллер | | Пересчитать кэшированные измерения, которые использует Scroller |
Скроллер | | Получить информацию о строках, которые отображаются в данный момент |
Скроллер | | Прокрутка к определенному индексу отображения строки |
SearchBuilder | | Возвращает узел контейнера SearchBuilder. |
SearchBuilder | | Получить подробную информацию о текущих настройках поиска |
SearchBuilder | | Восстановить поиск до заданного состояния |
SearchPanes | | Удаляет выбор на всех панелях |
SearchPanes | | Возвращает узел контейнера панелей. |
SearchPanes | | Восстановите панель, собрав параметры из таблицы. |
SearchPanes | | Измените размер всех панелей, чтобы должным образом заполнить контейнер SearchPanes. |
Выберите ячейку | | Отменить выделение отдельной ячейки |
Выберите | | Выбрать одну ячейку |
Выберите | | Отменить выбор ячеек |
Выберите | | Выбрать ячейки |
Выберите столбец | | Отменить выбор одного столбца |
Выберите | | Выберите одну колонку |
Выберите | | Отменить выбор столбцов |
Выберите | | Выбрать столбцы |
Выберите | | Отменить выделение одной строки |
Выберите | | Выберите одну строку |
Выбрать | | Отменить выбор строк |
Выберите | | Выбрать строки |
Выбрать | | Инициализация Выбрать вне конструктора |
Выбрать | | Получить / установить голубое состояние опций выбора элементов таблицы |
Выбрать | | Получить / установить состояние отображения сводной информации |
Выбрать | | Получить / установить элементы, которые Select будет выбирать на основе взаимодействия с пользователем (строки, столбцы или ячейки) |
Выбрать | | Получить / установить селектор элементов для захвата событий мыши |
Выбрать | | Получить / установить стиль, с помощью которого конечный пользователь может выбирать элементы в таблице |
Выбрать | | Получить / установить поведение, если элементы могут быть отменены при щелчке по выбранному элементу на |
вид | Тип идентификатора ресурса. |
etag | Только выход. Хеш этого ресурса. |
id | Только выход. Непрозрачный идентификатор, однозначно идентифицирующий таблицу. |
SelfLink | Только выход.URL-адрес, который можно использовать для повторного доступа к этому ресурсу. |
таблица Ссылка | Обязательно. Ссылка, описывающая идентификатор этой таблицы. |
friendlyName | Необязательно.Описательное имя для этой таблицы. |
описание | Необязательно. Удобное описание этой таблицы. |
этикетки | Ярлыки, связанные с этой таблицей.Вы можете использовать их для организации и группировки таблиц. Ключи и значения меток не могут быть длиннее 63 символов, могут содержать только строчные буквы, цифры, символы подчеркивания и дефисы. Допускаются международные символы. Значения метки необязательны. Ключи меток должны начинаться с буквы, и каждая метка в списке должна иметь разные ключи. Объект, содержащий список из |
схема | [Необязательно] Описывает схему этой таблицы. |
время Разбивка | Если указано, настраивает разбиение по времени для этой таблицы. |
диапазон Разбивка на разделы | Если указано, настраивает разделение диапазонов для этой таблицы. |
кластеризация | Спецификация кластеризации для таблицы.Должно быть указано с разбиением по времени, данные в таблице будут сначала разбиты, а затем кластеризованы. |
requirePartitionFilter | [Необязательно] Если задано значение true, запросы по этой таблице требуют указания фильтра раздела, который можно использовать для исключения раздела. |
числоБайт | Только выход.Размер этой таблицы в байтах, исключая любые данные в буфере потоковой передачи. |
numLongTermBytes | Только выход. Количество байтов в таблице, которые считаются «долгосрочным хранилищем». |
число строк | Только выход.Количество строк данных в этой таблице, исключая любые данные в буфере потоковой передачи. |
Время создания | Только выход. Время создания этой таблицы в миллисекундах с начала эпохи. |
expirationTime | Необязательно.Время истечения срока действия этой таблицы в миллисекундах с начала эпохи. Если нет, таблица будет существовать бесконечно. Таблицы с истекшим сроком действия будут удалены, а их хранилище освобождено. Свойство defaultTableExpirationMs инкапсулирующего набора данных можно использовать для установки expirationTime по умолчанию для вновь созданных таблиц. |
lastModifiedTime | Только выход.Время последнего изменения этой таблицы в миллисекундах с начала эпохи. |
тип | Только выход. Описывает тип таблицы. Поддерживаются следующие значения: ТАБЛИЦА: обычная таблица BigQuery. ПРОСМОТР: виртуальная таблица, определенная SQL-запросом. ВНЕШНИЙ: таблица, которая ссылается на данные, хранящиеся во внешней системе хранения, такой как Google Cloud Storage.MATERIALIZED_VIEW: предварительно вычисленное представление, определенное запросом SQL. Значение по умолчанию — ТАБЛИЦА. |
вид | Необязательно. Определение представления. |
материализованный Просмотр | Необязательно.Определение материализованного представления. |
externalDataConfiguration | Необязательно. Описывает формат данных, расположение и другие свойства таблицы, хранящейся вне BigQuery. Определяя эти свойства, можно запрашивать источник данных, как если бы это была стандартная таблица BigQuery. |
местонахождение | Только выход. Географическое положение, в котором находится таблица. Это значение наследуется от набора данных. |
потоковый буфер | Только выход.Содержит информацию о буфере потоковой передачи этой таблицы, если таковой имеется. Это поле будет отсутствовать, если таблица не передается в поток или если в буфере потоковой передачи нет данных. |
шифрование Конфигурация | Пользовательская конфигурация шифрования (например, ключи Cloud KMS). |
снимок Определение | Только выход. Содержит информацию о снимке. Это значение устанавливается при создании снимка. |
Введение в API таблиц Azure Cosmos DB
- 2 минуты на чтение
В этой статье
ПРИМЕНЯЕТСЯ К: Таблица API
Azure Cosmos DB предоставляет API таблиц для приложений, написанных для хранилища таблиц Azure и нуждающихся в расширенных возможностях, таких как:
Приложения, написанные для хранилища таблиц Azure, могут мигрировать в Azure Cosmos DB с помощью API таблиц без изменения кода и использовать преимущества расширенных возможностей.Table API имеет клиентские SDK, доступные для .NET, Java, Python и Node.js.
Столовые предложения
Если вы в настоящее время используете хранилище таблиц Azure, вы получите следующие преимущества, перейдя на API таблиц Azure Cosmos DB:
Элемент | Хранилище таблиц Azure | API таблиц Azure Cosmos DB |
---|---|---|
Задержка | Быстро, но без ограничений по задержке. | Задержка в миллисекундах для чтения и записи с задержкой <10 мс для чтения и записи в 99-м процентиле, в любом масштабе, в любой точке мира. |
Пропускная способность | Модель с переменной производительностью. Таблицы имеют предел масштабируемости 20 000 операций в секунду. | Высокая масштабируемость с выделенной зарезервированной пропускной способностью для каждой таблицы, поддерживаемой соглашениями об уровне обслуживания. Учетные записи не имеют верхнего предела пропускной способности и поддерживают> 10 миллионов операций в секунду на таблицу. |
Глобальная дистрибуция | Одна область с одной дополнительной читаемой вторичной областью чтения для обеспечения высокой доступности. | Глобальная дистрибуция «под ключ» из одного в любое количество регионов.Поддержка автоматического и ручного переключения при отказе в любое время и в любой точке мира. Несколько областей записи, чтобы любой регион мог принимать операции записи. |
Индексирование | Только первичный индекс для PartitionKey и RowKey. Вторичных индексов нет. | Автоматическое и полное индексирование всех свойств по умолчанию, без управления индексами. |
Запрос | При выполнении запроса используется индекс для первичного ключа, в противном случае выполняется сканирование. | Queries может использовать автоматическое индексирование свойств для сокращения времени выполнения запросов. |
Согласованность | Сильный в основном регионе. Возможен в пределах вторичного региона. | Пять четко определенных уровней согласованности для компромисса между доступностью, задержкой, пропускной способностью и согласованностью в зависимости от потребностей вашего приложения. |
Стоимость | На основе потребления. | Доступно как в режиме использования, так и в режиме выделенной емкости. |
SLA | Доступность от 99,9% до 99,99%, в зависимости от стратегии репликации. | Доступность для чтения 99,999%, доступность записи 99,99% для учетной записи с одним регионом и доступность записи 99,999% для учетных записей с несколькими регионами. Комплексные соглашения об уровне обслуживания, охватывающие доступность, задержку, пропускную способность и согласованность. |
Начать
Создайте учетную запись Azure Cosmos DB на портале Azure. Затем начните работу с нашим Quick Start for Table API с помощью .NET.
Важно
Если вы создали учетную запись Table API во время предварительного просмотра, создайте новую учетную запись Table API для работы с общедоступными SDK Table API.
Следующие шаги
Вот несколько советов для начала:
API REST службы таблиц — служба хранилища Azure
- 2 минуты на чтение
В этой статье
Сервис таблиц предлагает структурированное хранилище в виде таблиц. API службы таблиц — это REST API для работы с таблицами и данными, которые они содержат.
Примечание
Эта документация по REST API применима как к хранилищу таблиц Azure, так и к API таблиц Azure Cosmos DB.
Операции REST API
REST API для службы таблиц включает операции, перечисленные в следующей таблице.
Эксплуатация | Описание |
---|---|
Установить свойства службы таблицы | Устанавливает свойства службы таблиц. |
Получить свойства службы таблиц | Получает свойства службы таблиц. |
Запрос таблицы предпечатной проверки | Запрашивает правила совместного использования ресурсов между источниками (CORS) для службы таблиц перед отправкой фактического запроса. |
Получить статистику обслуживания таблиц | Получает статистику, относящуюся к репликации для службы таблиц. Эта операция доступна только на вторичной конечной точке расположения, если для учетной записи хранения включена геоизбыточная репликация с доступом для чтения. |
Таблицы запросов | Перечисляет таблицы в учетной записи хранения. |
Создать таблицу | Создает новую таблицу в учетной записи хранения. |
Удалить таблицу | Удаляет таблицу из учетной записи хранения. |
Получить таблицу ACL | Возвращает сведения о любых сохраненных политиках доступа, указанных в таблице, которые могут использоваться с подписями общего доступа. |
Набор столовый ACL | Устанавливает сведения о любых сохраненных политиках доступа, указанных в таблице, которые могут использоваться с общими подписями доступа. |
Сущности запроса | Запрашивает данные в таблице. |
Вставить объект | Вставляет новую сущность в таблицу. |
Вставить или объединить объект | Вставляет или объединяет объект в таблицу. |
Вставить или заменить объект | Вставляет или заменяет объект в таблице. |
Обновить объект | Обновляет существующий объект в таблице, заменяя его. |
Слияние | Обновляет существующую сущность в таблице путем объединения новых значений свойств в сущность. |
Удалить объект | Удаляет объект в таблице |
Операции группы организаций
Служба таблиц поддерживает пакетные операции для операций вставки сущности, обновления сущности, слияния сущности и удаления сущности. Дополнительные сведения о пакетных операциях см. В разделе Выполнение транзакций группы сущностей.
В этом разделе
Обзор функциональных возможностей табличных сервисов
Концепции сервировки стола
Операции над счетом (Табличный сервис)
Операции над таблицами
Операции с объектами
См. Также
Услуги хранения REST
Table API — Material-UI
Документация API компонента Table React. Узнайте больше о реквизитах и точках настройки CSS.
Импорт
Импорт таблицы из '@ material-ui / core / Table';
импортировать {Таблицу} из '@ material-ui / core';
Вы можете узнать больше о различиях, прочитав это руководство.
Имя компонента
Имя MuiTable
может использоваться для предоставления свойств по умолчанию или переопределений стиля на уровне темы.
Стойка
Имя | Тип | По умолчанию | Описание |
---|---|---|---|
детский * | узел | Содержимое таблицы, обычно TableHead и TableBody . | |
классы | объект | Переопределить или расширить стили, примененные к компоненту. См. CSS API ниже для получения более подробной информации. | |
компонент | elementType | ‘стол’ | Компонент, используемый для корневого узла. Либо строка для использования HTML-элемента, либо компонента. |
набивка | «по умолчанию» | ‘флажок’ | «нет» | ‘по умолчанию’ | Позволяет TableCells наследовать заполнение таблицы. |
размер | малый | ‘средний’ | ‘средний’ | Позволяет TableCells наследовать размер таблицы. |
липкий заголовок | булев | ложь | Установить липкий заголовок. ⚠️ Не работает с IE 11. |
Ссылка
перенаправляется в корневой элемент.
Любые другие предоставленные реквизиты будут предоставлены корневому элементу (собственный элемент).
CSS
Название правила | Глобальный класс | Описание |
---|---|---|
корень | .MuiTable-root | Стили, примененные к корневому элементу. |
липкий заголовок | .MuiTable-stickyHeader | . Стили, применяемые к корневому элементу, если stickyHeader = {true} . |
Вы можете переопределить стиль компонента с помощью одной из этих точек настройки:
Если этого недостаточно, вы можете проверить реализацию компонента для получения более подробной информации.
Демо
Консоль.table () — Веб-API | MDN
Отображает табличные данные в виде таблицы.
Эта функция принимает один обязательный аргумент data
, который должен быть массивом или
объект и один дополнительный необязательный параметр columns
.
Регистрирует данные
в виде таблицы. Каждый элемент в массиве (или перечислимом свойстве
если данные
— объект) будет строкой в таблице.
Первый столбец в таблице будет иметь номер (индекс)
.Если data
— это массив, тогда его значения будут индексами массива. Если data
— это объект, тогда его значения будут именами свойств. Обратите внимание, что
(в Firefox) console.table
ограничено отображением 1000 строк (первая строка
помеченный индекс).
Коллекции примитивных типов
Аргумент data
может быть массивом или объектом.
console.table ([«яблоки», «апельсины», «бананы»]);
function Person (firstName, lastName) {
это.firstName = firstName;
this.lastName = lastName;
}
var me = new Person («Джон», «Смит»);
console.table (я);
Коллекции составных типов
Если элементы в массиве или свойства в объекте сами являются массивами или объекты, то их элементы или свойства перечисляются в строке, по одному на столбец:
var people = [["Джон", "Смит"], ["Джейн", "Доу"], ["Эмили", "Джонс"]]
console.table (люди);
function Person (firstName, lastName) {
это.firstName = firstName;
this.lastName = lastName;
}
var john = new Person («Джон», «Смит»);
var jane = new Person («Джейн», «Лань»);
var emily = new Person («Эмили», «Джонс»);
console.table ([Джон, Джейн, Эмили]);
Обратите внимание, что если массив содержит объекты, то столбцы помечаются свойством название.
var family = {};
family.mother = new Person («Джейн», «Смит»);
family.father = new Person («Джон», «Смит»);
family.daughter = новый человек («Эмили», «Смит»);
приставка.стол (семейный);
Ограничение отображаемых столбцов
По умолчанию console.table ()
перечисляет все элементы в каждой строке. Ты можешь использовать
необязательный параметр columns
для выбора подмножества столбцов для отображения:
function Person (firstName, lastName) {
this.firstName = firstName;
this.lastName = lastName;
}
var john = new Person («Джон», «Смит»);
var jane = new Person («Джейн», «Лань»);
var emily = new Person («Эмили», «Джонс»);
приставка.стол ([Джон, Джейн, Эмили], ["firstName"]);
Сортировка столбцов
Вы можете отсортировать таблицу по определенному столбцу, щелкнув метку этого столбца.
консоль.таблица (данные);
console.table (данные, столбцы);
Параметры
-
данные
- Данные для отображения. Это должен быть либо массив, либо объект.
-
столбец
- Массив, содержащий имена столбцов для включения в вывод.
Таблицы BCD загружаются только в браузере
Параметры таблиц · Bootstrap Table
API параметров таблицы Bootstrap Table.
Параметры таблицы определены в jQuery.fn.bootstrapTable.defaults
.
–
ajax
ajaxOptions
Атрибут:
data-ajax-options
Тип:
Объект
Деталь:
Дополнительные параметры для отправки запроса ajax.Список значений: jQuery.ajax.
По умолчанию:
{}
Пример: Опции AJAX
кнопок
Атрибут:
кнопки данных
Тип:
Функция
Деталь:
Эта опция позволяет создавать / добавлять пользовательские кнопки на «панель кнопок» (верхний правый угол таблицы).
Эти кнопки можно отсортировать с помощью опции таблицы buttonsOrder, для этого следует использовать используемый ключ / имя для события!Пользовательская кнопка легко настраивается, существуют следующие параметры:
-
текст
- Описание: эти параметры используются для параметра таблицы showButtonText.
- Тип:
Строка
-
значок
- Описание: этот параметр используется для параметра таблицы showButtonIcons.
- Тип:
Строка
— Требуется только класс значка, например.fa-пользователей
-
рендер
- Описание: Установите для этого параметра значение
false
, чтобы скрыть кнопку по умолчанию, кнопка снова становится видимой при добавлении атрибута данныхdata-show-BUTTONNAME = "true"
.
- Описание: Установите для этого параметра значение
-
атрибуты
- Описание: эта опция позволяет добавлять дополнительные атрибуты html e.грамм.
титул
- Тип:
Объект
- Пример:
{title: 'Заголовок кнопки'}
- Описание: эта опция позволяет добавлять дополнительные атрибуты html e.грамм.
-
HTML
- Описание. Если вы не хотите автоматически создавать HTML-код, вы можете использовать эту опцию для вставки собственного HTML-кода.
Параметр событияработает только в том случае, если пользовательский HTML-код содержит
name = "BUTTONNAME"
.
Если используется этот параметр, следующие параметры будут проигнорированы: - Тип:
Функция | Строка
- Описание. Если вы не хотите автоматически создавать HTML-код, вы можете использовать эту опцию для вставки собственного HTML-кода.
-
событие
- Описание: следует использовать, если вы хотите добавить событие на кнопку
- Тип:
Функция | Объект | Строка
Параметр
событие
можно настроить тремя способами.
Одно событие скликом
событие:Одно событие с самоопределенным типом события:
{ 'мероприятие': { 'mouseenter': () => {} } }
Несколько событий с самоопределенными типами событий:
{ 'мероприятие': { 'click': () => {}, 'mouseenter': () => {}, 'mouseleave': () => {} } }
Подсказка: Вместо встроенных функций вы также можете использовать имена функций.
Настроенная настраиваемая кнопка может выглядеть так:
{ btnRemoveEvenRows: { 'text': 'Удалить четные строки', 'icon': 'fa-trash', 'событие': () => { // ДЕЛАЙТЕ МАТЕРИАЛЫ, ЧТОБЫ УДАЛИТЬ ЧЕТЫЕ РЯДЫ }, 'attributes': { 'title': 'Удалить все строки с четным идентификатором' } } }
-
По умолчанию:
{}
Пример: Кнопки
кнопок Выровнять
Атрибут:
выравнивание кнопок данных
Тип:
Строка
Деталь:
Укажите, как выровнять кнопки панели инструментов.Можно использовать
«левый»
,«правый»
.По умолчанию:
«справа»
Пример: Кнопки выравниваются
кнопок Класс
Атрибут:
data-button-class
Тип:
Строка
Деталь:
Определяет класс (добавлен после
'btn-'
) кнопок таблицы.По умолчанию:
вторичный
Пример: Кнопки Класс
кнопок Заказать
Атрибут:
data-buttons-order
Тип:
Массив
Деталь:
Укажите, как настроить порядок кнопок панели инструментов.
По умолчанию:
['paginationSwitch', 'refresh', 'toggle', 'fullscreen', 'columns']
Пример: Кнопки Порядок
кнопок Приставка
Атрибут:
префикс кнопок данных
Тип:
Строка
Деталь:
Определяет префикс кнопок таблицы.
По умолчанию:
'btn'
Пример: Префикс кнопок
Атрибут:
data-buttons-toolbar
Тип:
Строка / узел
Деталь:
Селектор jQuery, который указывает панель инструментов настраиваемых кнопок, например:
# buttons-toolbar
,.buttons-toolbar
или узел DOM.По умолчанию:
undefined
Пример: Панель инструментов кнопок
кэш
картаПросмотр
Атрибут:
просмотр карты данных
Тип:
Логическое значение
Деталь:
Установите
true
для отображения таблицы просмотра карточек, например мобильного представления.По умолчанию:
ложь
Пример: Просмотр карты
Атрибут:
data-checkbox-header
Тип:
Логическое значение
Деталь:
Установите
false
, чтобы скрыть флажок проверки всех в строке заголовка.По умолчанию:
true
Пример: Заголовок флажка
классы
Атрибут:
классы данных
Тип:
Строка
Деталь:
Имя класса таблицы.
'стол'
,'стол с окантовкой'
,'стол с наведением'
,'стол с полосой'
,'стол-темный'
,'стол-см'
и'стол- borderless '
можно использовать. По умолчанию таблица имеет рамку.По умолчанию:
'table-Borded table-hover'
Пример: Классы таблиц
Нажмите, чтобы выбрать
Атрибут:
выбор данных по щелчку мыши
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы установить флажок или переключатель при щелчке по строкам.По умолчанию:
ложь
Пример: Щелкните, чтобы выбрать
столбцов
contentType
Атрибут:
тип содержимого-данных
Тип:
Строка
Деталь:
ContentType запроса удаленных данных, например:
application / x-www-form-urlencoded
.По умолчанию:
'application / json'
Пример: Тип содержимого
на заказ Искать
Атрибут:
поиск по данным
Тип:
Функция
Деталь:
Функция пользовательского поиска выполняется вместо встроенной функции поиска, принимает три параметра:
-
данные
: данные таблицы. -
текст
: поисковый текст. -
фильтр
: объект фильтра из методаfilterBy
.
Пример использования:
-
function customSearch (data, text) {
return data.filter (function (row) {
вернуть row.field.indexOf (текст)> -1
})
}
на заказ Сортировать
Атрибут:
data-custom-sort
Тип:
Функция
Деталь:
Пользовательская функция сортировки выполняется вместо встроенной функции сортировки, принимает три параметра:
-
sortName
: имя сортировки. -
sortOrder
: порядок сортировки. -
данные
: данные строк.
-
По умолчанию:
undefined
Пример: Индивидуальный заказ
данные
Атрибут:
данные-данные
Тип:
Массив | Объект
Деталь:
Данные для загрузки.
Если в данных есть свойство
_
или_rowspan _
, то ячейки будут объединены автоматически, например:_colspan $ table.bootstrapTable ({ данные: [ { id: 1, имя: 'Элемент 1', _name_rowspan: 2, цена: "$ 1" }, { id: 2, цена: "$ 2" } ] })
При использовании этой функции данные
По умолчанию:
[]
Пример: Из данных
dataField
Атрибут:
поле данных-данных
Тип:
Строка
Деталь:
Введите входящий json, содержащий
"строк"
списка данных.По умолчанию:
'строки'
Пример: Итого / Поле данных
dataType
Атрибут:
data-data-type
Тип:
Строка
Деталь:
Тип данных, которые вы ожидаете от сервера.
По умолчанию:
'json'
Пример: Тип данных
деталь Фильтр
Атрибут:
фильтр-детали-данные
Тип:
Функция
Деталь:
Включите расширение для каждой строки, если для
detailView
установлено значениеtrue
.Верните true, и строка будет включена для расширения, верните false, и расширение для строки будет отключено. Функция по умолчанию возвращает значение true, чтобы разрешить раскрытие для всех строк.По умолчанию:
функция (индекс, строка) {return true}
Пример: Детальный фильтр
детальFormatter
Атрибут:
форматирование-детали-данные
Тип:
Функция
Деталь:
Отформатируйте подробное представление, если для
detailView
установлено значениеtrue
.Верните строку, и она будет добавлена в ячейку подробного представления, при необходимости визуализировать элемент напрямую, используя третий параметр, который является элементом jQuery целевой ячейки.По умолчанию:
функция (индекс, строка, элемент) {return ''}
Пример: Детальный вид
подробноПросмотреть
Атрибут:
подробное представление данных
Тип:
Логическое значение
Деталь:
Установите для
значение
для отображения таблицы подробных представлений.По умолчанию:
ложь
Пример: Детальный вид
деталиViewAlign
Атрибут:
data-detail-view-align
Тип:
Строка
Деталь:
Укажите, как выровнять значок подробного вида. Можно использовать
«левый»
,«правый»
.По умолчанию:
«левый»
Пример: Детальный вид Align
подробноПросмотретьПо клику
Атрибут:
данные-детали-просмотр по щелчку
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы переключать подробный вид при щелчке по ячейке.По умолчанию:
ложь
Пример: Значок детального просмотра
детальПросмотретьИконку
Атрибут:
значок-подробные-данные-представления
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы отобразить столбец подробного представления (значок плюс / минус).По умолчанию:
true
Пример: Значок детального просмотра
побег
Атрибут:
экранирование данных
Тип:
Логическое значение
Деталь:
Экранирует строку для вставки в HTML, заменяя символы &, <,>, «,` и ‘.
По умолчанию:
ложь
Пример: Table Escape
filterOptions
Атрибут:
параметры фильтра данных
Тип:
Логическое значение
Деталь:
Определите параметры фильтра по умолчанию для алгоритма,
filterAlgorithm: 'и'
означает, что весь заданный фильтр должен соответствовать,filterAlgorithm: 'или'
означает, что один из заданных фильтров должен соответствовать.По умолчанию:
{filterAlgorithm: 'и'}
Пример: Параметры фильтра
Атрибут:
поле нижнего колонтитула данных
Тип:
Строка
Деталь:
Определяет ключ объекта нижнего колонтитула (из массива данных или ответа сервера json).Объект нижнего колонтитула можно использовать для установки / определения колонтитула и / или значения нижнего колонтитула.
{
"строки": [
{
"id": 0,
"name": "Элемент 0",
"цена": "0 долларов",
«количество»: 3
}
],
"нижний колонтитул": {
"id": "идентификатор нижнего колонтитула",
"_id_colspan": 2,
"name": "название нижнего колонтитула"
}
}
Атрибут:
в стиле нижнего колонтитула данных
Тип:
Функция
Деталь:
Функция форматирования стиля нижнего колонтитула принимает один параметр:
-
столбец
: объект столбца.
Поддержка
классов
илиcss
. Пример использования:-
function footerStyle (column) {
возвращаться {
css: {'font-weight': 'normal'},
классы: 'мой-класс'
}
}
Атрибут:
стиль заголовка данных
Тип:
Функция
Деталь:
Функция форматирования стиля заголовка принимает один параметр:
-
столбец
: объект столбца.
Поддержка
классов
илиcss
. Пример использования:-
function headerStyle (column) {
возвращаться {
css: {'font-weight': 'normal'},
классы: 'мой-класс'
}
}
высота
иконок
{
paginationSwitchDown: 'fa-каретка-квадрат-вниз',
paginationSwitchUp: 'fa-каретка-квадрат-вверх',
обновить: 'fa-sync',
toggleOff: 'fa-toggle-off',
toggleOn: 'fa-toggle-on',
столбцы: 'fa-th-list',
полноэкранный режим: 'fa-стрелки-альт',
detailOpen: 'fa-plus',
detailClose: 'fa-minus'
}
значок Размер
Атрибут:
размер значка данных
Тип:
Строка
Деталь:
Определяет размер значка, можно использовать
undefined
,'lg'
,'sm'
.По умолчанию:
undefined
Пример: Размер значка
иконок Приставка
Атрибут:
префикс значков данных
Тип:
Строка
Деталь:
Определяет имя набора значков (
'glyphicon'
или'fa'
для FontAwesome).По умолчанию'fa'
используется для Bootstrap v4.По умолчанию:
'fa'
- Пример: Префикс значков
idField
Атрибут:
поле идентификатора данных
Тип:
Строка
Деталь:
Укажите, какое поле будет использоваться как значение флажка / переключателя, его аналог для selectItemName.
По умолчанию:
undefined
- Пример: Id Поле
ignoreClickToSelectOn
Атрибут:
игнорирование данных-щелчок для выбора
Тип:
Функция
Деталь:
Включите элементы игнорирования
clickToSelect
.Принимает один параметр:-
элемент
: элемент, на котором щелкнули.
Вернуть true, если щелчок следует игнорировать, и false, если щелчок должен вызвать выделение строки. Эта опция актуальна, только если
clickToSelect
истинно.-
По умолчанию:
{return ['A', 'BUTTON']. Includes (tagName)}
Пример: Игнорировать Щелкните для выбора на
loadingFontSize
Атрибут:
размер шрифта загрузки данных
Тип:
Строка
Деталь:
Чтобы определить размер шрифта загружаемого текста, значение по умолчанию -
'auto'
, оно будет рассчитано автоматически в соответствии с шириной таблицы, от 12 до 32 пикселей.По умолчанию:
'авто'
Пример: Размер загружаемого шрифта
loadingШаблон
Атрибут:
шаблон загрузки данных
Тип:
Функция
Деталь:
Самостоятельно настроить тип загрузки.Объект параметров содержит:
- loadingMessage: локаль формата
LoadingMessage
.
- loadingMessage: локаль формата
- По умолчанию:
function (loadingMessage) { вернуть '' + '' + loadingMessage + '' + ' ' + '' }
- Пример: Загрузка шаблона
локаль
Атрибут:
локаль данных
Тип:
Строка
Деталь:
Устанавливает используемый языковой стандарт (т.е.е.
«ж-ЦН»
). Файлы локали должны быть предварительно загружены. Позволяет использовать резервные языковые стандарты, если они загружены, в следующем порядке:- Первая попытка выбора языкового стандарта, как указано,
- Затем пробует языковой стандарт с "_", переведенным в "-", и код региона в верхнем регистре,
- Затем пробует короткий код локали (например,
'zh'
вместо'zh-CN'
), - И, наконец, будет использоваться последний загруженный файл языковых стандартов (или языковой стандарт по умолчанию, если языковые стандарты не загружены).
Если осталось
undefined
или пустая строка, используйте последний загруженный языковой стандарт (или'en-US'
, если файлы языкового стандарта не загружены).По умолчанию:
undefined
Пример: Локаль таблицы
поддерживатьMetaData
Атрибут:
обслуживание-метаданные-данные
Тип:
Логическое значение
Деталь:
Установите для
истину
, чтобы поддерживать следующие метаданные на странице изменений и поиске:- выбранные строки
- скрытых строк
По умолчанию:
ложь
Пример: Ведение метаданных
метод
minimumCountColumns
Атрибут:
столбцы минимального количества данных
Тип:
Номер
Деталь:
Минимальное количество столбцов, которое нужно скрыть из раскрывающегося списка столбцов.
По умолчанию:
1
Пример: Минимальное количество столбцов
несколькоSelectRow
Атрибут:
data-multiple-select-row
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы включить строку множественного выбора.Можно использовать Ctrl + щелчок для выбора одной строки или использовать Shift + щелчок для выбора диапазона строк.По умолчанию:
ложь
Пример: Несколько строк выбора
Список
страниц
Атрибут:
список-страниц-данных
Тип:
Массив
Деталь:
При установке свойства разбивки на страницы инициализируйте список выбора размера страницы.Если вы включите опцию
«все
» или«без ограничений»
, все записи будут показаны в вашей таблице.Подсказка: если в таблице есть меньшие строки в качестве параметров, параметры будут скрыты автоматически, чтобы отключить эту функцию, вы можете установить для smartDisplay значение
false
По умолчанию:
[10, 25, 50, 100]
Пример: Список страниц
номер страницы
Атрибут:
номер страницы данных
Тип:
Номер
Деталь:
При установке свойства разбивки на страницы инициализируйте номер страницы.
По умолчанию:
1
Пример: Номер страницы
страниц Размер
Атрибут:
размер страницы данных
Тип:
Номер
Деталь:
При установке свойства разбивки на страницы инициализируйте размер страницы.
По умолчанию:
10
Пример: Размер страницы
Атрибут:
разбивка на страницы
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы отображать панель инструментов нумерации страниц в нижней части таблицы.По умолчанию:
ложь
Пример: Пагинация таблицы
Атрибут:
data-pagination-detail-h-align
Тип:
Строка
Деталь:
Укажите, как выровнять деталь нумерации страниц. Можно использовать
«левый»
,«правый»
.По умолчанию:
«левый»
Пример: Pagination H Align
Атрибут:
data-pagination-h-align
Тип:
Строка
Деталь:
Укажите, как выровнять нумерацию страниц. Можно использовать
«левый»
,«правый»
.По умолчанию:
«справа»
Пример: Pagination H Align
Атрибут:
цикл разбивки на страницы данных
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы включить режим непрерывного цикла нумерации страниц.По умолчанию:
true
Пример: Цикл разбиения на страницы
Атрибут:
data-pagination-next-text
Тип:
Строка
Деталь:
Укажите значок или текст, который будет отображаться в деталях разбивки на страницы, следующая кнопка.
По умолчанию:
'›'
Пример: Текст разбивки на страницы
Атрибут:
разбивка на страницы рядом с данными
Тип:
Номер
Деталь:
Количество страниц с каждой стороны (справа, слева) текущей страницы.
По умолчанию:
1
Пример: Номер индекса нумерации страниц
Атрибут:
data-pagination-parts
Тип:
Массив
Деталь:
Эти параметры определяют, какие части разбивки на страницы должны быть видны.
-
pageInfo
Показывает, какой набор данных будет отображаться на текущей странице (например,Отображение с 1 по 10 из 54 строк
). -
pageInfoShort
Похож наpageInfo
, но отображает только количество строк в таблице (например,Отображает 54 строки
). -
pageSize
Показывает раскрывающийся список, который определяет, сколько строк должно отображаться на странице. -
pageList
Показывает основную часть нумерации страниц (список страниц).
-
По умолчанию:
['pageInfo', 'pageSize', 'pageList']
Пример: Части нумерации страниц
Атрибут:
data-pagination-pre-text
Тип:
Строка
Деталь:
Укажите значок или текст, который будет отображаться в детали нумерации страниц, предыдущая кнопка.
По умолчанию:
'‹'
Пример: Текст разбивки на страницы
Атрибут:
размер последовательной разбивки на страницы
Тип:
Номер
Деталь:
Максимальное количество последовательных страниц в строке.
По умолчанию:
5
Пример: Номер индекса нумерации страниц
Атрибут:
разбивка на страницы-данные-промежуточное использование
Тип:
Логическое значение
Деталь:
Расчет и отображение промежуточных страниц для быстрого доступа.
По умолчанию:
ложь
Пример: Номер индекса нумерации страниц
Атрибут:
data-pagination-v-align
Тип:
Строка
Деталь:
Укажите, как выровнять нумерацию страниц по вертикали.
'верхний'
,'нижний'
,'оба'
(поместите нумерацию страниц сверху и снизу).По умолчанию:
«снизу»
Пример: Pagination V Align
queryParams
Атрибут:
параметры-запроса-данных
Тип:
Функция
Деталь:
При запросе удаленных данных вы можете отправить дополнительные параметры, изменив queryParams.
Если
queryParamsType = 'limit'
, объект params содержит:limit
,смещение
,search
,sort
,order
.Иначе, он содержит:
pageSize
,pageNumber
,searchText
,sortName
,sortOrder
.Вернуть
false
, чтобы остановить запрос.По умолчанию:
функция (параметры) {параметры возврата}
Пример: Параметры запроса
queryParamsType
Атрибут:
data-query-params-type
Тип:
Строка
Деталь:
Установите
'limit'
для отправки параметров запроса с типом RESTFul.По умолчанию:
«предел»
Пример: Тип параметров запроса
запомнить Заказ
Атрибут:
запоминание данных
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы запомнить порядок для каждого столбца.По умолчанию:
ложь
Пример: Запомнить заказ
responseHandler
Атрибут:
обработчик ответа-данных
Тип:
Функция
Деталь:
Перед загрузкой удаленных данных обработчик формата данных ответа, объект параметров содержит:
-
res
: данные ответа. -
jqXHR
: объект jqXHR, который представляет собой супернабор объекта XMLHTTPRequest. Для получения дополнительной информации см. Тип jqXHR.
-
По умолчанию:
function (res) {return res}
Пример: Обработчик ответа
row Атрибуты
Атрибут:
атрибуты строки данных
Тип:
Функция
Деталь:
Функция форматирования атрибутов строки принимает два параметра:
-
строка
: данные записи строки. -
index
: индекс строки.
Поддержка всех настраиваемых атрибутов.
-
По умолчанию:
{}
Пример: Атрибуты строки
rowStyle
Атрибут:
стиль строки данных
Тип:
Функция
Деталь:
Функция форматирования стиля строки принимает два параметра:
-
строка
: данные записи строки. -
index
: индекс строки.
Поддержка классов или css.
-
По умолчанию:
{}
Пример: Стиль строки
поиск
Атрибут:
поиск данных
Тип:
Логическое значение
Деталь:
Разрешить поисковый ввод.
Есть 3 способа поиска:
- Значение содержит поисковый запрос (по умолчанию). Пример: Github содержит git.
- Значение должно совпадать с поисковым запросом. Пример: Github (значение) и Github (поисковый запрос).
- Сравнения (<,>, <=, = <,> =, =>). Пример: 4 больше 3.
Примечание. Если вы хотите использовать пользовательский ввод для поиска, используйте searchSelector.
По умолчанию:
ложь
Пример: Поиск по таблице
searchAccentNeutralise
Атрибут:
поиск-данные-акцент-нейтрализация
Тип:
Логическое значение
Деталь:
Установите значение
true
, если вы хотите использовать функцию нейтрализации акцента.По умолчанию:
ложь
Пример: Search Accent Neutralize
searchAlign
Атрибут:
data-search-align
Тип:
Строка
Деталь:
Укажите, как выровнять поисковый ввод. Можно использовать
«левый»
,«правый»
.По умолчанию:
«справа»
Пример: Search Align
поиск Выделить
Атрибут:
поиск-данные-выделение
Тип:
Логическое значение
Деталь:
Установите значение
true
, чтобы выделить искомый текст (с помощью тегаПо умолчанию:
«ложь»
Пример: Выделение поиска
searchOnEnterKey
Атрибут:
поиск данных по ключу ввода
Тип:
Логическое значение
Деталь:
Метод поиска будет выполняться, пока не будет нажата клавиша Enter.
По умолчанию:
ложь
Пример: Поиск по клавише ввода
searchSelector
Атрибут:
поиск-селектор данных
Тип:
Boolean | Строка
Деталь:
Если эта опция установлена (должен быть действующий селектор dom e.грамм.
#customSearch
), найденный элемент dom (должен быть элементом вводаПо умолчанию:
ложь
Пример: Селектор поиска
searchText
Атрибут:
текст-поиск-данные
Тип:
Строка
Деталь:
При установке свойства поиска инициализируйте текст для поиска.
По умолчанию:
''
Пример: Поисковый текст
searchTimeOut
Атрибут:
тайм-аут поиска данных
Тип:
Номер
Деталь:
Установить тайм-аут для поискового огня.
По умолчанию:
500
Пример: Время ожидания поиска
selectItemName
Атрибут:
data-select-item-name
Тип:
Строка
Деталь:
Имя радио или флажка.
По умолчанию:
'btSelectItem'
Пример: Id Поле
serverSort
Атрибут:
data-server-sort
Тип:
Логическое значение
Деталь:
Установите
false
для сортировки данных на стороне клиента, работает только тогда, когдаsidePagination
- этоserver
.По умолчанию:
true
Пример: Сортировка сервера
показатьButtonIcons
Атрибут:
Показать значки кнопок
Тип:
Логическое значение
Деталь:
На всех кнопках будут отображаться значки
По умолчанию:
true
Пример: показать значки кнопок
показатьButtonText
Атрибут:
Показать текст кнопки
Тип:
Логическое значение
Деталь:
На всех кнопках будет отображаться текст
По умолчанию:
ложь
Пример: показать текст кнопки
показать Колонны
Атрибут:
столбцы-показы данных
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы отображался раскрывающийся список столбцов.Мы можем установить для параметрапереключаемый столбец
значениеfalse
, чтобы скрыть элемент столбцов в раскрывающемся списке.По умолчанию:
ложь
Пример: Основные столбцы и большие столбцы
показатьКолонныПоиск
Атрибут:
поиск-столбцы-данные
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы отобразить поиск фильтра столбцов.По умолчанию:
ложь
Пример: Поиск по столбцам
показатьColumnsToggleAll
Атрибут:
data-show-columns-toggle-all
Тип:
Логическое значение
Деталь:
Установите для
значение true
, чтобы отобразить флажок «Переключить все» в параметрах / раскрывающемся списке столбцов.По умолчанию:
ложь
Пример: Столбцы Переключить все
Атрибут:
data-show-extended-pagination
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы показать расширенную версию разбивки на страницы (включая количество всех строк без фильтров).Если вы используете разбиение на страницы на стороне сервера, пожалуйста, используйтеtotalNotFilteredField
для определения количества.По умолчанию:
ложь
Пример: Показать расширенную пагинацию
Атрибут:
data-show-footer
Тип:
Логическое значение
Деталь:
Задайте для
значение
, чтобы показать строку нижнего колонтитула сводки.По умолчанию:
ложь
Пример: Показать нижний колонтитул
показатьПолноэкранный
Атрибут:
data-show-fullscreen
Тип:
Логическое значение
Деталь:
Установите
на истинное значение
, чтобы отображалась кнопка полноэкранного режима.По умолчанию:
ложь
Пример: Показать в полноэкранном режиме
Атрибут:
заголовок-шоу-данных
Тип:
Логическое значение
Деталь:
Установите
false
, чтобы скрыть заголовок таблицы.По умолчанию:
true
Пример: Показать заголовок
Атрибут:
data-show-pagination-switch
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы отображалась кнопка переключения нумерации страниц.По умолчанию:
ложь
Пример: Показать переключатель разбивки на страницы
показатьRefresh
Атрибут:
data-show-refresh
Тип:
Логическое значение
Деталь:
Установите
на истинное значение
, чтобы отображалась кнопка обновления.По умолчанию:
ложь
Пример: Показать Обновить
показать
Атрибут:
data-show-search-button
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы кнопка поиска отображалась за полем поиска.Поиск будет выполняться только при нажатии кнопки (например, для предотвращения трафика или времени загрузки).По умолчанию:
ложь
Пример: Показать кнопку поиска
показать
Атрибут:
data-show-search-clear-button
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы за полем поиска отображалась кнопка очистки, которая очищает ввод поиска (а также все фильтры из элемента управления фильтром (если он включен)).По умолчанию:
ложь
Пример: Показать кнопку очистки поиска
показатьToggle
Атрибут:
data-show-toggle
Тип:
Логическое значение
Деталь:
Установите
на истинное значение
, чтобы отобразить кнопку переключения для переключения просмотра таблицы / карты.По умолчанию:
ложь
Пример: Показать переключатель
Атрибут:
нумерация страниц на стороне данных
Тип:
Строка
Деталь:
Определяет боковую нумерацию страниц таблицы, может быть только
«клиент»
или«сервер»
.Для использования«сервер» на стороне
требуется либо параметр«url»
, либо параметр«ajax»
.Обратите внимание, что требуемый формат ответа сервера различается в зависимости от того, для параметра
'sidePagination'
установлено значение'client'
или'server'
. См. Следующие примеры:По умолчанию:
«клиент»
Пример: Пагинация на стороне клиента и разбивка на страницы на стороне сервера
бесшумная сортировка
Атрибут:
тихая сортировка данных
Тип:
Логическое значение
Деталь:
Установите
false
для сортировки данных с сообщением о загрузке.Эти параметры работают, когда для параметра sidePagination установлено значение«сервер»
.По умолчанию:
true
Пример: Тихая сортировка
одиночный Выбрать
Атрибут:
одинарный выбор данных
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы разрешить флажок, выбирающий только одну строку.По умолчанию:
ложь
Пример: Однократный выбор
smartDisplay
Атрибут:
data-smart-display
Тип:
Логическое значение
Деталь:
Установите
true
для интеллектуального отображения нумерации страниц или карточек.По умолчанию:
true
Пример: Smart Display
сортируемый
sortClass
Атрибут:
класс сортировки данных
Тип:
Строка
Деталь:
Имя класса сортируемых элементов
td
.По умолчанию:
undefined
Пример: Класс сортировки
sortName
Атрибут:
имя-сортировки данных
Тип:
Строка
Деталь:
Определяет, какой столбец будет отсортирован.
По умолчанию:
undefined
Пример: Сортировать Имя Порядок
сортироватьЗаказать
Атрибут:
порядок сортировки данных
Тип:
Строка
Деталь:
Определяет порядок сортировки столбцов, может быть только
undefined
,asc
илиdesc
.По умолчанию:
undefined
Пример: Сортировать Имя Порядок
Сортировка Сбросить
Атрибут:
сортировка-сброс данных
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы сбросить сортировку при третьем щелчке.По умолчанию:
ложь
Пример: Сброс сортировки
sortStable
Атрибут:
стабильная сортировка данных
Тип:
Логическое значение
Деталь:
Установите
true
для стабильной сортировки. Мы добавим в строку свойство'_position'
.По умолчанию:
ложь
Пример: Стабильная сортировка
строгий поиск
Атрибут:
строгий поиск данных
Тип:
Логическое значение
Деталь:
Включить строгий поиск. Отключает сравнительные проверки.
По умолчанию:
ложь
Пример: Строгий поиск
theadClasses
Атрибут:
data-thead-classes
Тип:
Строка
Деталь:
Имя класса таблицы thead. Bootstrap v4, используйте модификатор классов
.thead-light
или.thead-dark
, чтобы изображениеthead
выглядело светлым или темно-серым.По умолчанию:
''
Пример: Классы Thead
Атрибут:
панель инструментов данных
Тип:
Строка / узел
Деталь:
Селектор jQuery, указывающий на панель инструментов, например:
#toolbar
,.панель инструментов
или узел DOM.По умолчанию:
undefined
Пример: Пользовательская панель инструментов
Атрибут:
data-toolbar-align
Тип:
Строка
Деталь:
Укажите, как выровнять настраиваемую панель инструментов.Можно использовать
«левый»
,«правый»
.По умолчанию:
«левый»
Пример: Выровнять панель инструментов
Поле
Атрибут:
поле данных-итогов
Тип:
Строка
Деталь:
Введите входящий json, содержащий
«всего»
данных.По умолчанию:
«всего»
Пример: Итого / Поле данных
всего Не отфильтровано
Атрибут:
всего данных без фильтрации
Тип:
Номер
Деталь:
Это свойство в основном передается сервером пагинации, который прост в использовании.
По умолчанию:
0
NotFilteredField
Атрибут:
поле данных-всего-без фильтрации
Тип:
строка
Деталь:
Поле из ответа json, которое будет использоваться для
showExtendedPagination
.По умолчанию:
totalNotFiltered
Пример: Всего не отфильтровано поле
Всего строк
Атрибут:
данных-итоговых строк
Тип:
Номер
Деталь:
Это свойство в основном передается сервером пагинации, который прост в использовании.
По умолчанию:
0
комплектация
Атрибут:
обрезка данных при поиске
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы обрезать пробелы в поле поиска.По умолчанию:
true
Пример: Обрезка при поиске
undefined Текст
Атрибут:
текст неопределенных данных
Тип:
Строка
Деталь:
Определяет текст по умолчанию
undefined
.По умолчанию:
'-'
Пример: Неопределенный текст
уникальный идентификатор
Атрибут:
уникальный идентификатор данных
Тип:
Строка
Деталь:
Укажите уникальный идентификатор для каждой строки.
По умолчанию:
undefined
Пример: getRowByUniqueId
url
Атрибут:
URL-адрес данных
Тип:
Строка
Деталь:
URL-адрес для запроса данных с удаленного сайта.
Обратите внимание, что требуемый формат ответа сервера различается в зависимости от того, указана ли опция
'sidePagination'
. См. Следующие примеры:По умолчанию:
undefined
Пример: Из URL
Обработка ошибок
Чтобы получить ошибки загрузки, используйте onLoadError
Атрибут:
виртуальная прокрутка данных
Тип:
Логическое значение
Деталь:
Установите
true
, чтобы включить виртуальную прокрутку для отображения виртуального «бесконечного» списка.По умолчанию:
ложь
Пример: Большие данные
Атрибут:
data-virtual-scroll-item-height
Тип:
Номер
Деталь:
Если этот параметр не определен, по умолчанию мы будем использовать высоту первого элемента.
Важно предоставить это, если высота виртуального элемента будет значительно больше, чем высота по умолчанию. Это измерение используется для определения количества ячеек, которое должно быть создано при инициализации, и для расчета высоты прокручиваемой области. Это значение высоты может использовать только единиц
пикселей.
По умолчанию:
undefined
видимых Искать
Атрибут:
видимый поиск
Тип:
Логическое значение
Деталь:
устанавливает
true
для поиска только в видимом столбце / данных, если данные содержат другие значения, которые не отображаются, они будут проигнорированы при поиске.