Create domain

Prev Next

Available in Classic and VPC

You can create a domain by setting container types, sections, and indexes. Creating domains for each service or each environment, such as development, test, or operation, lets you generate a search engine that suits your purpose. In addition, you can use the save as draft feature to save domain creation information and create the domain later.

Create domain

To create a domain, follow these steps:

Note
  • Creating domain is possible only within 512 GB of the sum of used container memory per account.
  • Up to 5 domains can be created per account.
  • To create a domain using the database schema, check whether the network environment and user settings of the DB server allow access through the following Cloud Search access IPs.
    • In the VPC environment, when connecting to the DB server in the VPC environment owned by the same account: 169.254.83.16, 169.254.83.17
    • When connecting through the host and public IP of the DB server: 115.85.176.%
  1. From the NAVER Cloud Platform console, click i_menu > Services > Big Data & Analytics > Cloud Search in order.
  2. Click the Domain menu.
  3. Click the [Create domain] button.
  4. When the Create domain page appears, proceed with the following steps in order.

1. Enter basic information (VPC)

Enter the basic information of the domain.

  1. Enter the domain name and the domain description.
    • The domain name must begin with a letter or an underscore (_). You can only enter 3 to 20 characters consisting of letters, numbers, underscores (_), and hyphens (-).
  2. Select the container type.
  3. Click i-cloudsearch-minus and i-cloudsearch-plus to enter the number of search containers.
    • You can enter a value between 1 and 8 and change it after you create a domain.
    • At the production level, we recommend at least 2 containers.
  4. Select whether to load the schema of an existing domain or database in Load and then click the [Next] button.
    • Unselected: does not load the existing schema
    • Defined schema: create a domain using the schema provided as a demo or the schema of the existing domain
      • In the Select schema dropdown menu, select the demo schema (car) or the name of an existing domain
    • Database: create a domain using the database schema
      • Enter the database access information and then click the [Check database connection] button
        • Host environment: select the environment of the DB server to connect
          • VPC: select when connecting to the DB server in the VPC environment held by your account
          • Cloud DB (VPC): select when connecting to the Cloud DB server held by your account
          • Public IP (host): select when connecting through the public IP of the DB server or public domain
        • Server name (when selecting VPC): select the DB server from the dropdown menu
        • Host or IP (when selecting Public IP (host)): enter the public IP of the DB server or public domain address
        • Database type: select the type of DB server to connect
        • Port: enter the connection port of the DB server
        • Database name: enter the name of the database where the data is stored
        • User name and password: enter the user information to be used when Cloud Search connects to the DB server
        • Character set: enter the character set of the DB to connect
      • Target table name: select the table where the data is stored
        • Activate after verifying the database connection

1. Enter basic information (Classic)

Enter the basic information of the domain.

  1. Enter the domain name and the domain description.
    • The domain name must begin with a letter or an underscore (_). You can only enter 3 to 20 characters consisting of letters, numbers, underscores (_), and hyphens (-).
  2. Select the container type.
  3. Click i-cloudsearch-minus and i-cloudsearch-plus to enter the number of search containers.
    • You can enter a value between 1 and 8 and change it after you create a domain.
    • At the production level, we recommend at least 2 containers.
  4. Select whether to load the schema of an existing domain or database in Load and then click the [Next] button.
    • Unselected: does not load the existing schema
    • Defined schema: create a domain using the schema provided as a demo or the schema of the existing domain
      • In the Select schema dropdown menu, select the demo schema (car) or the name of an existing domain
    • Database: create a domain using the database schema
      • Enter the database access information and then click the [Check database connection] button
        • Host or IP: enter the public IP of the DB server or public domain address
        • Database type: select the type of DB to connect
        • Port: enter the connection port of the DB server
        • Database name: enter the name of the database where the data is stored
        • User name and password: enter the user information to be used when Cloud Search connects to the DB server
        • Character set: enter the character set of the DB to connect
      • Target table name: select the table where the data is stored
        • Activate after verifying the database connection

2. Set section

Sections represent the items that comprise a document, and they are similar to columns in a database. To add sections to a domain and set up main sections, follow these steps:

  1. Enter the section name, select the database type from the ranking variable (data type) dropdown menu, and then click the [Add] button.
    • Only letters, numbers, and underscores (_) can be entered for section names.
    • You must configure the sections identically to the schema of the document you want to search.
    • If you load the schema of the existing domain or database, the schema is automatically added.
    • [Initialization] button: delete all sections
    • [Multiple input] button: enter multiple sections at once on a popup window
    • i-cloudsearch-delete: delete added section
  2. Add sections by repeating the first step and then click Main status to select a main section.
    • You cannot edit or delete sections after domain creation.
    • The main section serves a key role in the search target document, so you cannot change it after domain creation.
  3. Click the [Next] button.
Note

Ranking variables do not represent data types but are variables indicating properties of the section. Therefore, the type doesn't need to be the same when you create the domain from DB.

  • When searching documents, you can sort, aggregate, and restrict searches (scope, user_scope) using ranking variables (section properties).
  • If you do not sort, aggregate, or restrict searches (scope, user_scope) based on section properties, do not add ranking variables.
  • Adding unnecessary ranking values takes up additional space and consumes more time when uploading documents or editing indexes.
  • For the sections where ranking variables are added, some processing features for query results are restricted. (such as highlighting and passage's max_length)

3. Set index

Create an index based on your search purpose. You can add multiple builds to a single index. A build is composed of the search target section, section weight, and analysis option.

Note

To create an index, follow these steps:

  1. Click the [Add] button.

  2. Enter the index name.

    • Only letters, numbers, and underscores (_) can be entered.
  3. In Enable term location, select whether to record location information for indexed terms. (Y: enable, N: disable)

    Caution

    If you select enable, you cannot change the number of builds when editing indexes. (The array size of the buildInfos must be the same.)

  4. Select the document weight function.

    • Document weight function: function to aggregate section weight by build
    • Sum: select the sum_wgt function (calculate the total weight)
    • Max: select the max_wgt function (calculate the maximum value of the weight)
  5. Enter the build information and then click the [Add] button to add builds.

    • Name: enter the build name
    • Section weight: set the weight to be applied to each section when calculating ranking scores
      • When search keywords match the value of the section, a higher section weight leads to a higher ranking in search results.
    • Creation target (section): select the section to which the build is applied (multiple selection possible)
    • Analysis option: select the analyzer and thesaurus to be used for document indexing
    • i-cloudsearch-delete: delete the added build
  6. Once you finish adding builds, click the [Add] button.

  7. Repeat steps 1 to 6 to add more indexes.

    • You cannot delete indexes after domain creation.
    • [Edit] button: select the index you want to edit and then click to edit the index
    • [Delete] button: select the index you want to delete and then click to delete the index
    • [Initialization] button: delete all indexes
  8. Click the [Next] button.

4. Final confirmation

After reviewing your settings, click the [Create] button.

  • It may take up to 10 minutes for a new domain to be created.
  • You can temporarily save your settings by clicking the [Save as draft] button.
    • Clicking a domain in draft status in the domain list lets you create a domain using the temporarily saved setting information.
Note

Even if you create a domain using a defined schema or an existing database schema, you still need to upload documents separately. For more information on uploading documents, see Upload documents.