NAS에 MariaDB(MySQL)를 설치는 했는데..어떻게 사용해야 할까요? (약 1시간 정도 고민..) 

역시 가장 만만한 RESTfull 서비스를 만들어서 호출하면 되겠죠? 그렇다면, Azure에서 RESTfull 서비스를 만들어서 CRUD를 해 볼까요?


MySQL과 연결하는 서비스를 만드는 것이 저도 처음이라 엄청난 삽질을 했습니다. ㅋㅋ 간단하지는 않네요.



0. 참고

NAS에 Database를?

NorthWind Database 생성

Visual Studio를 사용하여 Azure App Service에서 웹앱 문제 해결

ERROR 1044 (42000): Access denied for user ''@'localhost' to database 'db'

Connect C# to MySQL



1. MySQL에 NorthWind Database 생성


참고에 있는 NorthWind Database 생성 페이지에서 Northwind.MySQL5.sql을 다운로드 합니다.


SQLyog 프로그램을 실행해서 DB에 접속하고, 다운로드받은 쿼리를 불러온 후 실행하면, northwind db가 생성됩니다.




2. 셈플 프로젝트 생성


Visual Studio를 실행하고 New -> Project를 선택하고 다음과 같이 선택합니다.



ASP.NET Web Application을 선택합니다. 여기서 해당 내용들이 나오지 않는다면, 비주얼 스튜디오를 설치할 때 웹 관련 항목을 선택하지 않았기 때문입니다. 그리고, Azure와 관련된 최신 업데이트를 완료하세요.


OK를 입력하여 다음 화면으로 넘어 갑니다.



여기서 Azure API App을 선택하고, OK를 클릭합니다.


프로젝트 생성 완료!



3. MySQL 사용을 위한 준비


프로젝트에서 오른쪽 버튼을 눌러 NuGet packages를 선택합니다.


Browse 탭에서 MySQL을 검색해서 MySQL.Data를 선택하고 설치합니다.




4. MySQLHelper


DB에 접속해서 쿼리를 실행시키는 부분을 헬퍼 클래스로 분리 합니다.


    /// <summary>
    ///     MySQL 헬퍼 클래스
    /// </summary>
    public class MySQLHelper
    {
        private static MySQLHelper _instance;

        private MySqlConnection _connection;

        /// <summary>
        ///     생성자
        /// </summary>
        public MySQLHelper()
        {
            Initialize();
        }

        /// <summary>
        ///     인스턴스
        /// </summary>
        public static MySQLHelper Instance => _instance ?? (_instance = new MySQLHelper());

        /// <summary>
        ///     초기화
        /// </summary>
        private void Initialize()
        {
            var server = "NAS 외부접속 아이피";
            var database = "northwind";
            var uid = "kakiadmin";
            var password = "비밀번호";
            var connectionString =
                $"SERVER={server};DATABASE={database};UID={uid};Pwd={password};SslMode=none;";

            _connection = new MySqlConnection(connectionString);
        }

        /// <summary>
        ///     연결
        /// </summary>
        /// <returns></returns>
        private Tuple<bool, string> OpenConnection()
        {
            try
            {
                _connection.Open();
                return new Tuple<bool, string>(true, null);
            }
            catch (MySqlException ex)
            {
                //When handling errors, you can your application's response based
                //on the error number.
                //The two most common error numbers when connecting are as follows:
                //0: Cannot connect to server.
                //1045: Invalid user name and/or password.
                switch (ex.Number)
                {
                    case 0:
                        Debug.WriteLine("Cannot connect to server.  Contact administrator");
                        break;

                    case 1045:
                        Debug.WriteLine("Invalid username/password, please try again");
                        break;
                }

                return new Tuple<bool, string>(false, ex.Message);
            }
        }

        /// <summary>
        ///     연결 종료
        /// </summary>
        /// <returns></returns>
        private bool CloseConnection()
        {
            try
            {
                _connection.Close();
                return true;
            }
            catch (MySqlException ex)
            {
                Debug.WriteLine(ex.Message);
                return false;
            }
        }

        /// <summary>
        ///     연결 테스트
        /// </summary>
        /// <returns></returns>
        public async Task<string> GetConnectTestAsync()
        {
            var ds = new DataSet();
            var query = "SELECT * FROM Employees";
            var result = OpenConnection();
            if (result.Item1 == false) return result.Item2;
            var adpt = new MySqlDataAdapter(query, _connection);
            //var cmd = new MySqlCommand(query, _connection);
            await adpt.FillAsync(ds);
            CloseConnection();
            return "success connecting";
        }

        /// <summary>
        ///     결과 반환하지 않는 쿼리 실행, Insert, Update, Delete
        /// </summary>
        /// <param name="query"></param>
        /// <returns></returns>
        public async Task<string> ExecuteNonQueryAsync(string query)
        {
            if (string.IsNullOrEmpty(query)) return "Empty strings are not supported.";
            var result = OpenConnection();
            if (result.Item1 == false) return result.Item2;
            var cmd = new MySqlCommand(query, _connection);
            var resultExecute = await cmd.ExecuteNonQueryAsync();
            CloseConnection();
            return resultExecute.ToString();
        }

        /// <summary>
        ///     결과 반환하는 쿼리 실행 Select
        /// </summary>
        /// <param name="query"></param>
        /// <returns></returns>
        public async Task<DataSet> ExecuteAsync(string query)
        {
            if (string.IsNullOrEmpty(query)) return null;
            var ds = new DataSet();
            var result = OpenConnection();
            if (result.Item1 == false) return null;
            var adpt = new MySqlDataAdapter(query, _connection);
            await adpt.FillAsync(ds);
            CloseConnection();
            return ds;
        }
    }


Initialize()에 접속 아이디와 비밀번호는 지난번 포스트에서 이야기 했듯이 telnet으로 연결해서 직접 추가를 해주어야 합니다.


mysql에 root 아이디로 접속


$ mysql -uroot -p


kakiadmin 아이디 추가


mysql> CREATE USER 'kakiadmin'@'192.168.35.1' IDENTIFIED BY 'your_password';
mysql
> grant all privileges on *.* to 'kakiadmin'@'192.168.35.1';


여기서 주의할 사항은 아이디를 추가할 때 뒤에 붙이는 아이피는 집에서 테스트를 할 때는 게이트웨이 주소를 넣으셔야 하며, 차후 Azure에 서비스를 올리면 Azure 서비스에서 사용하는 아이피를 넣어야 한다는 것입니다. 


동일한 이름을 가지고 있어서 호출하는 Ip에 맞춰서 아이디가 각각 존재해야 한다는 점입니다.


어떤 아이피를 가지는 아이디를 추가해야하는지 확인하기 위해서 GetConnectTest 메소드를 호출하면 됩니다.



5. ValuesController.cs 수정


        /// <summary>
        ///     연결 테스트
        /// </summary>
        /// <returns></returns>
        [Route("~/getconnecttest")]
        public async Task<string> GetConnectTest()
        {
            return await MySQLHelper.Instance.GetConnectTestAsync();
        }


위의 코드를 추가한 후 실행하면 브라우저에서는 HTTP Error 403.14 - Forbidden 이런 오류가 출력되는데 무시하고, localhost:12267을 복사한 후 postman을 이용해서 테스트를 해봅니다.


정상적으로 연결이 완료되고, 데이터를 조회했다면 다음과 같은 결과가 반환됩니다.

실패했을 경우 1045 오류가 발생하면서, 메시지가 나오는데 그 곳에 나오는 아이피를 이용해서 아이디를 추가해주시면 됩니다.


여기서 제가 실패하지 않는 이유는 이미 로컬 아이피를 이용해서 계정을 등록해 놓았기 때문입니다. 처음하시는 분들은 여기서 반드시 오류가 발생합니다. 9번 항목을 참고해서 처리하세요



6. 데이터 조회


        // GET api/values
        [SwaggerOperation("GetAll")]
        public async Task<DataSet> Get()
        {
            return await MySQLHelper.Instance.ExecuteAsync("SELECT * FROM Products");
        }


ValuesController.cs에 Get메소드를 위와 같이 수정하고 실행 합니다.


postman에서 http://localhost:12267/api/values를 호출하면 결과가 반환 됩니다.


DataSet을 Json형태로 변환해서 반환합니다.

물론 여기서는 쿼리를 미리 입력해서 처리했지만, request로 받아서 처리할수도 있겠죠? 쿼리를 직접 받기 위해서는 Post를 이용해야 합니다.



7. 쿼리 직접 입력 받아서 실행하기


        // POST api/values
        [SwaggerOperation("Create")]
        [SwaggerResponse(HttpStatusCode.Created)]
        public async void Post([FromBody]JObject value)
        {
            var query = value["value"].ToString();
            var result = await MySQLHelper.Instance.ExecuteNonQueryAsync(query);
        }


ValueController.cs를 위와 같이 수정합니다. 특히 string을 JObject로 수정하는 것을 잊으면 않됩니다.


수정 완료 후 postman에서 아래와 같이 호출합니다.


post를 선택하고, http://localhost:12267/api/values를 입력합니다.

headers에 content-type은 x-www-form-urlencoded로 지정되어 있어야 하며, Body에 x-www-form-urlencoded를 선택한 후 value, INSERT Employees(LastName, FirstName) VALUES('Park','MunChan'); 를 각각 입력 후 send를 누릅니다.


물론 반환되는 결과는 없습니다. 호출후 db를 조회해보면 Employees 테이블에 레코드가 하나 추가되어있는 것을 볼 수 있습니다.



8. 서비스를 Azure에 올리기


프로젝트에서 마우스 오른쪽 -> Publish를 선택하면 아래와 같은 화면이 나옵니다. Create New에서 Publish를 눌러줍니다.



Create App Service에서 App 이름을 지정하고, 서브스크립션을 선택합니다. 비주얼 스튜디오 로그인된 계정으로 가입된 Azure 계정을 찾는것이 기본이며, 다른 계정을 선택하실 수도 있습니다. 


MVP는 MSDN 서브스크립션을 가지고 있기 때문에 선택했습니다. 그외 Resource Group, Hosting Plan등은 사용자가 임으로 만들어서 사용하시면 됩니다.


Create 버튼을 눌러서 서비스를 생성하면 됩니다.



배포가 완료되면 



완료화면이 출력됩니다. 이제 서비스를 호출해서 테스트 합니다.



9. 마무리 작업


postman으로 http://mysqlsample2018.azurewebsites.net/getconnecttest 주소를 get 호출하면


"Authentication to host 'xx.xx.xx.xx' for user 'kakiadmin' using method 'mysql_native_password' failed with message: Access denied for user 'kakiadmin'@'52.231.xx.xxx' (using password: YES)"


위와 같은 오류가 발생합니다. 즉, kakiadmin으로 MySQL 에 로그인을 하지 못했다는 내용입니다. 그런데 찾는 계정이 'kakiadmin'@'52.231.xx.xxx' 입니다. 이런 경우 해당 계정을 MySQL 에 추가해 주어야만 로그인이 가능합니다.


추가!!

뒤에 ip부분을 생략하고 싶으면 kakiadmin@% 이렇게 만들면 어떤 아이피든지 통과가 가능합니다. ㅜㅜ



4번에 있는 방법을 이용해서 계정을 추가해 주면 완료 가능합니다.


아이디를 추가한 후 다시 호출해보니 success connecting이라는 메시지가 출력되었습니다.


마지막으로 조회를 테스트해보니 정상적으로 조회되는 것을 알 수 있습니다.

최종 소스에서 조회하는 테이블을 Employees로 변경했습니다.


http://mysqlsample2018.azurewebsites.net/api/values


{
    "Table": [
        {
            "ProductID": 1,
            "ProductName": "Chai",
            "SupplierID": 1,
            "CategoryID": 1,
            "QuantityPerUnit": "10 boxes x 20 bags",
            "UnitPrice": 18,
            "UnitsInStock": 39,
            "UnitsOnOrder": 0,
            "ReorderLevel": 10,
            "Discontinued": 0
        },
        {
            "ProductID": 2,
            "ProductName": "Chang",
            "SupplierID": 1,
            "CategoryID": 1,
            "QuantityPerUnit": "24 - 12 oz bottles",
            "UnitPrice": 19,
            "UnitsInStock": 17,
            "UnitsOnOrder": 40,
            "ReorderLevel": 25,
            "Discontinued": 0
        },

.....



10. Azure debug


에저에 올라간 서비스의 에러를 확인하기 위해서는 참고에 있는 내용을 참고하시면 될 것 같습니다.



11. 소스

https://github.com/kaki104/ConnectingAzureToMySQL


블로그 이미지

MVP kaki104

* Microsoft MVP - Windows Development 2014 ~ 2019 5ring * LINE : kaki104 * facebook : https://www.facebook.com/kaki104 https://www.facebook.com/groups/w10app/

집에 NAS가 하나 있습니다. 모두 아시는 내용이죠?? 이 녀석 사용하지 좀 오래 된 듯한데.. 하여간 지금 시놀로지(헤놀로지) 5.2-5644 Update 5 버전이 설치가 되어있고, 영화, 음악, 사진 등을 잘 넣어서 보고있는데.. 



오늘 아침에 갑지가 이 녀석에게 DB 설치가 가능할 것 같다는 느낌이 딱! ... 결국 3시간 만에 성공을 한 것 같습니다.



0. 참고


https://m.blog.naver.com/PostView.nhn?blogId=oioi9i&logNo=220408830865&proxyReferer=https%3A%2F%2Fwww.google.co.kr%2F

http://zetawiki.com/wiki/MySQL_원격_접속_허용



1. 설치는 쉬웠다!



피키지 센터에 MariaDB가 있어서 찾아보니 과거 MySQL의 친구(?) 버전이라 호화성이나 성능이 괜찮을 것 같아서 설치하기로 하고, Install 버튼을 누르니 특별히 뭐 물어보는 것도 없이 바로 설치 완료..


으흠;;



2. Admin계정 비밀번호 등은??



물개를 클릭하면 간단한 윈도우가 하나 뜨는데..



Change MariaDB password 버튼을 클릭해서, root 계정의 비밀번호를 변경할 수 있습니다. root가 admin인 것 같습니다..아마도..



3. DB설치는 되었는데, 어떻게 접속을 해야하지??


마리아 DB TX Tools 폴더에 오면 Tools 다운로드가 지원됩니다. 

https://mariadb.com/downloads/mariadb-tx/tools 


SQLyog를 선택하고 Download 버튼을 클릭하면, 응용프로그램이 다운 됩니다. 14일간 트라이얼로 사용할 수 있는 버전으로 정식으로는 99불을 주고 사면 됩니다.


물론 MySQL과 동일하기 때문에 MySQL 관리가 가능한 다른 프로그램을 사용하셔도 상관 없습니다.



4. DB 접속 1차 시도


처음 시도는 역시 실패! 실패 이유는 DB가 외부접속을 허용하지 않기 때문입니다.


DB를 외부접속 가능하게 하려면.. 3개의 DB 커맨드를 날려야 하는데..


이 커맨드를 날릴려면 NAS에 Telnet으로 접속을 해야 합니다.



5. NAS에 Telnet으로 접속하기



NAS에 Telnet으로 접속하기 위해서는 Control Panel에서 Terminal & SNMP를 선택해서 Enable Telnet service, Enable SSH service 2개를 체크 해 주고, Apply를 클릭합니다.


이제 Telnet을 이용해서 NAS에 접속 할 수 있습니다. 음음..그런데 윈도에 기본적으로 Telnet 클라이언트 설치가 되어 있지 않으니 설치를 해야겠죠?


Telnet 클라이언트 설치하는 부분에 대해서는 설명을 생략하겠습니다.



6. Telnet 클라이언트로 NAS 접속, MariaDB 접속


윈도우에서 Windows PowerShell을 실행 하고, 다음의 명령을 입력해서 NAS에 연결합니다. 아이피 주소는 자신의 NAS IP 주소입니다.


telnet 192.168.35.94



아이디와 패스워드를 입력해야 하는데..원래 사용하던 계정으로 로그인이 앙되더라구요..그래서 admin 계정을 사용할 수 있게 변경해야합니다.(원래 사용하던 계정을 사용해서 로그인할 수 있으면 그걸로 그냥 하셔도 될 듯..)



User -> admin -> Disallow the user to change account password, Disable this account 2가지의 체크를 풀고, OK를 입력합니다. 


BusyBox v1.16.1 (2015-11-12 18:06:25 CST) built-in shell (ash)
Enter 'help' for a list of built-in commands.


kaki_server>


로그인이 완료되면 대충 이런 메시지가 출력됩니다. 후후


이제 MariaDB에 연결해서 쿼리를 날려줘야 하는데. db에 연결하는 명령어를 몰라서 찾아보니..


kaki_server> mysql -u root -p

Enter password:
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MariaDB connection id is 4
Server version: 5.5.47-MariaDB Source distribution


Copyright (c) 2000, 2015, Oracle, MariaDB Corporation Ab and others.


Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.


MariaDB [(none)]>


password는 아까 변경해준 녀석을 입력하시면 될 것 같습니다. 아마도..



7. 외부 접속 가능하도록 쿼리 입력


MariaDB [(none)]> INSERT INTO mysql.user (host,user,authentication_string,ssl_cipher, x509_issuer, x509_subject) VALUES ('%','root',password('패스워드'),'','','');
Query OK, 1 row affected (0.00 sec)


MariaDB [(none)]> GRANT ALL PRIVILEGES ON *.* TO 'root'@'%';
Query OK, 0 rows affected (0.00 sec)


MariaDB [(none)]> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)


굵은 글씨 부분을 차례대로 입력하시고, 패스워드는 패스워드를 입력해 주세요, 


여기까지 하시면 외부에서 db에 연결 할 수 있습니다.



8. DB 접속 2차 시도..


4번으로 돌아가서 비밀번호를 입력하고 connect를 입력하면~



짜잔~ 연결이 되었습니다.



9. 주의사항


telnet 접속이 가능하도록 열어 놓고 작업을 한 후 바로 닫아 주어야 합니다. 그렇지 않으면 무지막지한 공격이 들어옵니다..쿨럭..


블로그 이미지

MVP kaki104

* Microsoft MVP - Windows Development 2014 ~ 2019 5ring * LINE : kaki104 * facebook : https://www.facebook.com/kaki104 https://www.facebook.com/groups/w10app/

Tag mariaDB, mysql, Nas

티스토리 툴바