cassandra

Соединение с базой данных Apache Cassandra

развернуть все на странице

Описание

cassandra функция создает cassandra объект, который представляет Apache Cassandra® подключение к базе данных с помощью интерфейса Database Toolbox™ для Apache Cassandra® База данных.

Сначала необходимо установить интерфейс Database Toolbox для базы данных Apache Cassandra. Для получения дополнительной информации см. раздел «Интерфейс Database Toolbox для установки базы данных Apache Cassandra».

После создания cassandra объект, можно использовать функции объекта для импорта данных из базы данных Cassandra в MATLAB®. Также можно экспортировать данные из MATLAB в базу данных Cassandra. Можно также исследовать структуру базы данных и выполнять запросы Cassandra Query Language (CQL).

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

Создание

Синтаксис

c = cassandra(contactPoints)
c = cassandra(contactPoints,username,password)
c = cassandra(___,Name,Value)

Описание

пример

c = cassandra(contactPoints) создает соединение с базой данных Cassandra с помощью адреса хоста.

пример

c = cassandra(contactPoints,username,password) задает имя пользователя и пароль.

пример

c = cassandra(___,Name,Value) задает дополнительные опции, используя один или несколько аргументы пары "имя-значение" в дополнение к любой комбинации входных аргументов в предыдущих синтаксисах.

Входные параметры

расширить все

Адрес хоста для одного узла или адреса хоста для нескольких узлов в кластере Cassandra, заданный как вектор символов, строковый скаляр, массив ячеек из векторов символов или строковые массивы. Задайте вектор символов или строковый скаляр для одного узла. Или задайте массив ячеек из векторов символов или строковых массивов для нескольких узлов.

Можно задать локальный хост или IP-адрес другого компьютера в кластере Cassandra.

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

Пример: 'localhost'

Типы данных: cell | char | string

Имя пользователя, заданное как вектор символов или строковый скаляр. Если кластеру требуется проверка подлинности, используйте username входной параметр для имени пользователя.

Типы данных: char | string

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

Типы данных: char | string

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: c = cassandra(contactPoints,'PortNumber',3106,'SSLEnabled',true) создает SSL-соединение с базой данных Cassandra с использованием номера порта 3106.

Номер порта для соединения с хостом, заданный как разделенная разделенными запятой парами, состоящая из 'PortNumber' и числовой скаляр.

Типы данных: double

SSL-активированное соединение, заданное как разделенная разделенными запятой парами, состоящая из 'SSLEnabled' и значение false или true. Установка этого аргумента на true создает SSL-подключение к базе данных Cassandra.

Типы данных: logical

Свойства

расширить все

Имя кластера Кассандры, заданное как строковый скаляр.

Пример: "Test Cluster"

Типы данных: string

Адрес хоста для одного узла или адреса хоста для нескольких узлов в кластере Cassandra, заданный как строковый скаляр для одного узла или строковые массивы для нескольких узлов. Эти адреса включают адреса, указанные в contactPoints входной параметр.

Пример: "localhost/127.0.0.1"

Типы данных: string

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

Пример: "datacenter1"

Типы данных: string

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

Пример: ["employeedata" "system"]

Типы данных: string

Функции объекта

расширить все

closeЗакройте соединение с базой данных Apache Cassandra
isopenОпределите, открыто ли соединение с базой данных Apache Cassandra
columninfoПолучение сведений о столбцах из таблицы базы данных Apache Cassandra
partitionReadИмпорт данных из разделов таблицы базы данных Apache Cassandra
tablenamesСписок имен таблиц базы данных в базе данных Apache Cassandra
upsertВставка или обновление данных в базу данных Apache Cassandra
executecqlВыполните запрос CQL в базе данных Apache Cassandra

Примеры

свернуть все

Этот пример использует:

Открыть Live Script

Используя локальный адрес хоста, создайте соединение с базой данных Cassandra ® и отобразите ключевые пространства в базе данных.

Создайте соединение с базой данных Cassandra с помощью локального адреса хоста. 

contactPoints = "localhost";
conn = cassandra(contactPoints)
conn = 
  cassandra with properties:

                   Cluster: "Test Cluster"
             HostAddresses: "localhost/127.0.0.1"
           LocalDataCenter: "datacenter1"
                 Keyspaces: ["employeedata", "system", "system_auth" ... and 3 more]

conn является cassandra объект, который содержит следующие свойства:

  • Имя кластера

  • Адрес хоста

  • Имя локального центра обработки данных

  • Keyspaces

Отобразите ключевые пространства в базе данных Cassandra путем доступа к Keyspaces свойство cassandra объект.

conn.Keyspaces
ans = 1×6 string array
    "employeedata"    "system"    "system_auth"    "system_distributed"    "system_schema"    "system_traces"

Закройте соединение с базой данных Cassandra.

close(conn)

Этот пример использует:

Открыть Live Script

Используя локальный адрес хоста и аутентификацию, создайте соединение с базой данных Cassandra ® и отобразите ключевые пространства в базе данных.

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

contactPoints = "localhost";
username = "username";
password = "password";
conn = cassandra(contactPoints,username,password)
conn = 
  cassandra with properties:

                   Cluster: "Test Cluster"
             HostAddresses: "localhost/127.0.0.1"
           LocalDataCenter: "datacenter1"
                 Keyspaces: ["employeedata", "system", "system_auth" ... and 3 more]

conn является cassandra объект, который содержит следующие свойства:

  • Имя кластера

  • Адрес хоста

  • Имя локального центра обработки данных

  • Keyspaces

Отобразите ключевые пространства в базе данных Cassandra путем доступа к Keyspaces свойство cassandra объект.

conn.Keyspaces
ans = 1×6 string array
    "employeedata"    "system"    "system_auth"    "system_distributed"    "system_schema"    "system_traces"

Закройте соединение с базой данных Cassandra.

close(conn)

Этот пример использует:

Открыть Live Script

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

Создайте соединение с базой данных Cassandra с помощью локального адреса хоста. Укажите номер порта 9042 при помощи 'PortNumber' аргумент пары "имя-значение".

contactPoints = "localhost";
portnumber = 9042;
conn = cassandra(contactPoints,'PortNumber',portnumber)
conn = 
  cassandra with properties:

                   Cluster: "Test Cluster"
             HostAddresses: "localhost/127.0.0.1"
           LocalDataCenter: "datacenter1"
                 Keyspaces: ["employeedata", "system", "system_auth" ... and 3 more]

conn является cassandra объект, который содержит следующие свойства:

  • Имя кластера

  • Адрес хоста

  • Имя локального центра обработки данных

  • Keyspaces

Отобразите ключевые пространства в базе данных Cassandra путем доступа к Keyspaces свойство cassandra объект.

conn.Keyspaces
ans = 1×6 string array
    "employeedata"    "system"    "system_auth"    "system_distributed"    "system_schema"    "system_traces"

Закройте соединение с базой данных Cassandra.

close(conn)

Используя локальный адрес хоста и номер порта, создайте SSL-соединение с базой данных Cassandra и отобразите ключевые пространства в базе данных.

Создайте соединение с базой данных Cassandra с помощью локального адреса хоста. Укажите номер порта 9042 при помощи 'PortNumber' аргумент пары "имя-значение". Создайте соединение с поддержкой SSL путем установки 'SSLEnabled' аргумент пары "имя-значение" в true.

contactPoints = "localhost";
portnumber = 9042;
conn = cassandra(contactPoints,'PortNumber',portnumber, ...
    'SSLEnabled',true)
conn = 
  cassandra with properties:

                   Cluster: "Test Cluster"
             HostAddresses: "localhost/127.0.0.1"
           LocalDataCenter: "datacenter1"
                 Keyspaces: ["employeedata", "system", "system_auth" ... and 3 more]

conn является cassandra объект, который содержит следующие свойства:

  • Имя кластера

  • Адрес хоста

  • Имя локального центра обработки данных

  • Keyspaces

Отобразите ключевые пространства в базе данных Cassandra путем доступа к Keyspaces свойство cassandra объект.

conn.Keyspaces
ans = 1×6 string array
    "employeedata"    "system"    "system_auth"    "system_distributed"    "system_schema"    "system_traces"

Закройте соединение с базой данных Cassandra.

close(conn)

См. также

Темы

Внешние веб-сайты

Введенный в R2018b

Документация по Database Toolbox

Поддержка

Для просмотра документации необходимо авторизоваться на сайте